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Go 语言 是 由 谷歌 公司 在 2007 年 开始 开发 的 一 门 语言 , 目的 是 能 在 多 核心 时 代 高 效 编写 网 络 
应 用 程序 。Go 语言 的 创始 人 Robert Griesemer 、Rob Pike 和 Ken Thompson 都 是 在 计算 机 发 展 过 程 
中 作出 过 重要 贡献 的 人 。 自 从 2009 年 11 月 正式 公开 发 布 后 ，Go 语言 迅速 席卷 了 整个 互联 网 后 端 
开发 领域 ， 其 社区 里 不 断 涌现 出 类 似 vitess 、Docker 、etcd 、Consul 等 重量 级 的 开源 项 目 。 

在 Go 语言 发 布 后 ， 我 就 被 其 简洁 、 强 大 的 特性 所 吸引 ， 并 于 2010 年 开始 在 技术 聚会 上 宣 
传 Go 语言 ， 当 时 所 讲 的 题目 是 《Go 语言 : 互联 网 时 代 的 C》。 现 在 看 来 ，Go 语言 确实 很 好 地 
解决 了 互联 网 时 代 开 发 的 痛 点 ， 而且 入 门 门槛 不 高 ， 是 一 种 上 手 容易 、 威 力 强大 的 工具 。 试 想 一 
下 ， 不 需要 学 习 复杂 的 异步 逻辑 ， 使 用 习惯 的 顺序 方法 ， 就 能 实现 高 性 能 的 网 络 服务 ， 并 充分 利 
用 系统 的 多 个 核心 ， 这 是 多 么 美好 的 一 件 事情 。 

本 书 是 国外 Go 社区 多 年 经 验 积 累 的 成 果 。 本 书 默认 读者 已 经 具有 一 定 的 编程 基础 ， 希 望 更 
好 地 使 用 Go 语言 。 全 书 以 示例 为 基础 ， 详 细 介 绍 了 Go 语言 中 的 一 些 比较 深入 的 话题 。 对 于 有 经 
验 的 程序 员 来 说 ,很 容易 通过 学 习 书 中 的 例子 来 解决 自己 实际 工作 中 过 到 的 问题 。 辅 以 文字 介绍 ， 
读者 会 对 相关 问题 有 更 系统 的 了 解 和 认识 。 翻译 过 程 中 我 尽量 保持 了 原 书 的 叙述 方法 , 并 加 强 了 
叙述 逻辑 ， 和 希望 读者 会 觉得 清晰 易 读 。 

在 翻译 本 书 的 过 程 中 , 感谢 人 民 邮 电 出 版 社 编辑 杨 海 玲 老师 的 指导 和 进度 安排 ,让 本 书 能 
按时 与 读者 见面 。 感 谢谢 孟 军 对 译 稿 的 审 校 ,你 的 润色 使 译文 读 起 来 流畅 了 很 多 。 尤 其 要 感谢 
我 老婆 对 我 的 支持 ， 感 谢 你 能 理解 我 出 于 热爱 才 会 “ 乌 旬 ”在 计算 机 前 码 字 。 

最 后 , 感谢 读者 购买 此 书 。 希望 读者 在 探索 Go 语言 的 道路 上 , 能 够 享受 到 和 我 一 样 的 乐趣 。 
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在 计算 机 科学 领域 ， 提 到 不 同 寻 和 党 的 人 ， 总 会 有 一 些 名 字 会 内 现在 你 的 脑海 中 。Rob Pike、 
Robert Griesmier 和 Ken Thompson 就 是 其 中 几 个 。 他 们 3 个 人 负责 构建 过 UNIX、Plan 9、B、Java 
的 JVM HotSpot、V8、Strongtalk”、Sawzall、Ed、Acme 和 UTF8， 此 外 还 有 很 多 其 他 的 创造 。 
在 2007 年 , 这 3 个 人 凑 在 一 起 ,尝试 一 个 伟大 的 想法 : 综合 他 们 多 年 的 经 验 , 借鉴 已 有 的 语言 ， 
来 创建 一 门 与 众 不 同 的 、 全 新 的 系统 语言 。 他 们 随后 以 开源 的 形式 发 布 了 自己 的 实验 成 果 ,， 并 将 
这 种 语言 命名 为 “Go”。 如 果 按 照 现 在 的 路 线 发 展 下 去 ， 这 门 语言 将 是 这 3 个 人 最 有 影响 的 一 项 
创造 。 

当 人 们 聚 在 一 起 ， 纯 粹 是 为 了 让 世界 变 得 更 好 的 时 候 ， 往 往 也 是 他 们 处 于 最 佳 状态 的 时 候 。 
在 2013 年 ,为 了 围绕 Go 语言 构建 一 个 更 好 的 社区 ，Brian 和 Erik 联合 成 立 了 Gopher Academy， 
没 过 多 和 久 ，B 记 和 其 他 一 些 有 类 似 想 法 的 人 也 加 入 进来 。 他 们 首先 注意 到 ， 社 区 需要 有 一 个 地 方 
可 以 在 线 聚 集 和 分 享 素 材 ， 所 以 他 们 在 slack 创立 了 Go 讨论 版 和 Gopher Academy 博客 。 随 着 时 
间 的 推移 ， 社 区 越 来 越 大 ， 他 们 创建 了 世界 上 第 一 个 全 球 Go 语言 大 会 一 一 GopherCon。 随 着 与 
社区 更 深入 地 交流 , 他 们 意识 到 还 需要 为 广大 想 学 习 这 门 新 语言 的 人 提供 一 些 资源 , 所 以 他 们 开 
始 着 手写 一 本 书 ， 就 是 现在 你 手 里 拿 的 这 本 书 。 

为 Go 社区 贡献 了 大 量 的 时 间 和 精力 的 3 位 作者 ， 出 于 对 Go 语言 社区 的 热爱 写 就 了 这 本 书 。 
我 曾 在 B、Brian 和 Erik 身边 ， 见 证 了 他 们 在 不 同 的 环境 和 角色 (作为 Gopher Academy 博客 的 
编辑 ， 作 为 大 会 组 织 者 ， 其 至 是 在 他 们 的 日 常 工 作 中 ， 作 为 父亲 和 丈夫 ) 下 ， 都 会 认真 负责 地 撰 
写 和 修订 本 书 。 对 他 们 来 说 ,这 不 仅仅 是 一 本 书 , 也 是 对 他 们 心爱 的 语言 的 献礼 。 他 们 并 不 满足 
于 写 就 一 本 “好 ” 书 。 他 们 编写 、 审 校 ， 再 写 、 再 修改 ,再 三 推 殴 每 页 文字 、 每 个 例子 、 每 一 章 ， 
直到 认为 本 书 的 内 容 配 得 上 他 们 珍视 的 这 门 语言 。 

离开 一 门 使 用 舒服 、 掌 握 熟 练 的 语言 ， 去 学 习 一 门 不 仅 对 自己 来 说 ,对 整个 世界 来 说 都 是 全 
新 的 语言 ， 是 需要 勇气 的 。 这 是 一 条 人 迹 罕 至 ， 沿 途 充 满 bug， 只 有 少数 先行 者 熟悉 的 路 。 这 里 


































































































































































































@ 一 个 高 性 能 强 类 型 的 Smalltalk 实现 。 一 一 译 者 注 
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充满 了 意外 的 错误 ,文档 不 明确 或 者 缺失 ， 而 且 缺 少 可 以 拿 来 即 月 
才 会 选择 的 道路 。 如 果 你 正在 读 这 本 和 





的 代码 库 。 这 是 拓 荡 者、 先锋 
上， 那么 你 可 能 正在 踏 上 这 段 旅 途 。 

















本 书 自始至终 是 为 你 一 一 本 书 的 读者 精心 制作 的 一 本 探索 、 学 习 和 使 用 Go 语言 的 简洁 而 全 
面 的 指导 手册 。 在 全 世界 ， 你 也 不 会 找到 比 BL、Brian 和 Erik 更 好 的 导师 了 。 我 非常 高 兴 你 能 








开始 探索 Go 语言 的 优点 ， 期 望 能 在 线 上 和 线 下 大 会 上 遇 到 你 。 


Steve Francia 


Go 语言 开发 者 ，Hugo 、Cobra、Viper 和 SPF13-VIM 的 创建 人 
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那 是 2013 年 10 月 , 我 刚刚 花 几 个 月 的 时 间 写 完 GoingGo.net 博客 ， 就 接 到 了 Brian Ketelsen 
和 Erik St. Martin 的 电话 。 他 们 正在 写 这 本 书 ， 问 我 是 否 有 兴趣 参与 进来 。 我 立刻 抓 住 机 会 ， 参 
与 到 写作 中 。 当 时 ， 作 为 一 个 Go 语言 的 新 手 ， 这 是 我 进一步 了 解 这 门 语言 的 好 机 会 。 毕 竞 ， 与 
Brian 和 Erik 一 起 工作 、 一 起 分 享 获得 的 知识 ， 比 我 从 构建 博客 中 学 到 的 要 多 得 多 。 

完成 前 4 章 后 ,我 们 在 Manning 早期 访问 项 目 (MEAP ) 中 发 布 了 这 本 书 。 很 快 ， 我 们 收 到 
了 来 自 语言 团队 成 员 的 邮件 。 这 位 成 员 对 很 多 细节 提供 了 评审 意见 ， 还 附加 了 大 量 有 用 的 知识 、 
意见 、 鼓 励 和 支持 。 根 据 这 些 评审 意见 ,我 们 决定 从 头 开 始 重 写 第 2 章 , 并 对 第 4 章 进 行 了 全 面 
修订 。 据 我 们 所 知 ， 对 整 章 进行 重 写 的 情况 并 不 少见 。 通 过 这 段 重 写 的 经 历 ， 我 们 学 会 要 依靠 社 
区 的 帮助 来 完成 写作 ， 因 为 我 们 希望 能 立刻 得 到 社区 的 支持 。 

自 那 以 后 , 这 本 书 就 成 了 社区 努力 的 成 果 。 我 们 投入 了 大 量 的 时 间 研 究 每 一 章 ， 开 发 样 例 代 
码 , 并 和 社区 一 起 评审 、 讨 论 并 编辑 书 中 的 材料 和 代码 。 我 们 尽 了 最 大 的 努力 来 保证 本 书 在 技术 
上 没有 错误 ， 让 代码 符合 通用 习惯 ， 并 且 使 用 社区 认为 应 该 有 的 方式 来 教 Go 语言 。 同 时 ， 我 们 
也 融入 了 自己 的 思考 、 自 己 的 实践 和 自己 的 指导 方式 。 

我 们 希望 本 书 能 帮 你 学 习 Go 语言 ， 不 仅 是 当下 ， 就 是 多 年 以 后 ， 你 也 能 从 本 书 中 找到 有 用 
的 东西 。Brian 、Erik 和 我 总 会 在 线 上 帮助 那些 希望 得 到 我 们 帮助 的 人 。 如 果 你 购买 了 本 书 ， 谢 
谢 你 ， 来 和 我 们 打 个 招呼 吧 。 

































































































































































William Kennedy 


致谢 











我 们 花 了 18 个 月 的 时 间 来 写本 书 。 但 是 , 离开 下 面 这 些 人 的 支持 , 我 们 不 可 能 完成 这 本 书 : 
我 们 的 家 人 、 朋 友 、 同 学 、 同 事 以 及 导师 ， 整 个 Go 社区 ， 还 有 我 们 的 出 版 商 Manning。 

当 你 开始 撰写 类 似 的 书 时 ,你 需要 一 位 编辑 。 编 辑 不 仅 要 分 享 喜悦 与 成 就 , 而且 要 不 惜 一 切 
代价 ， 帮 你 渡 过 难关 。Jennifer Stout， 你 才华 横 浇 ， 善 于 指导 ， 是 很 棒 的 朋友 。 感 谢 你 这 段 时 间 
的 付出 , 尤其 是 在 我 们 最 需要 你 的 时 候 。 感谢 你 让 这 本 书 变 成 现实 。 还 要 感谢 为 本 书 的 开发 和 出 
版 作出 贡献 的 Manning 的 其 他 人 。 

每 个 人 都 不 可 能 知晓 一 切 ， 所 以 需要 社区 里 的 人 付出 时 间 和 学 识 。 感 谢 Go 社区 以 及 所 有 参 
与 本 书 不 同 阶段 书稿 评审 并 提供 反馈 的 人 。 特 别 感谢 Adam McKay、Alex Basile 、Alex Jacinto、 
Alex Vidal Anjan Bacchu 、Benoit Benedetti、Bill Katz\ Brian Hetro 、Colin Kennedy、 Doug Sparling,、 
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Jeffrey Lim Jesse Evans、 Kevin Jackson、 Mark Fisher、 Matt Zulak、 Paulo Pires、 Peter Krey、 Philipp 
K. Janert、Sam Zaydel 以 及 Thomas ORourke。 还 要 感谢 Jimmy Frasché， 他 在 出 版 前 对 本 书 书稿 
做 了 快速 、 准 确 的 技术 审 校 。 

这 里 还 需要 特别 感谢 一 些 人 。 

Kim Shrier， 从 最 开始 就 在 提供 评审 意见 ， 并 花 时 间 来 指导 我 们 。 我 们 从 你 那里 学 到 了 很 多 ， 
非常 感谢 。 因 为 你 ， 本 书 在 技术 上 达到 了 更 好 的 境界 。 

Bil Hathaway 在 写 书 的 最 后 一 年 ， 深 入 参与 ， 并 矫正 了 每 一 章 。 你 的 想法 和 意见 非常 宝 吕 
我 们 必须 给 予 BL“ 第 9 章 合 著者 ”的 头衔 。 没 有 B 记 的 参与 、 天 赋 以 及 努力 ， 就 没有 这 一 章 的 
存在 。 

我 们 还 要 特别 感谢 Cory Jacobson 、Jeffery Lim 、Chetan Conikee 和 Nan Xiao 为 本 书 持续 提供 
了 评审 意见 和 指导 ， 感 谢 Gabriel Aszalos 、Fatih Arslan 、Kevin Gillette 和 Jason Waldrip 帮助 评审 
样 例 代 码 ， 还 要 特别 感谢 Steve Francia 帮 有 我 们 作 序 ， 认 可 我 们 的 工作 。 

最 后 ， 我 们 真诚 地 感谢 我 们 的 家 人 和 朋友 。 为 本 书 付出 的 时 间 和 代价 ， 总 会 影响 到 你 所 
爱 的 人 。 
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这 致谢 


William Kennedy 


我 首先 要 感谢 Lisa， 我 美丽 的 妻子 ， 以 及 我 的 5 个 孩子 : Brianna 、Melissa 、Amanda 、Jarrod 
和 Thomas。Lisa， 我 知道 你 和 孩子 们 有 太 多 的 日 夜 和 周末 ， 缺 少 丈 夫 和 父亲 的 陪伴 。 感 谢 你 让 
我 这 段 时 间 全 力 投 入 本 书 的 工作 : 我 爱 你 们 ， 爱 你 们 每 一 个 人 。 

我 也 要 感谢 我 生意 上 的 伙伴 Ed Gonzalez 、 创 意 经 理 Erick Zelaya， 以 及 整个 Ardan 工作 室 的 
团队 。Ed, 感谢 你 从 一 开始 就 支持 我 。 没 有 你 ,我 就 无 法 完成 本 书 。 你 不 仅 是 生意 伙伴 ,还 是 朋 
友和 兄长 : 谢谢 你 。Erick， 感谢 你 为 我 、 为 公司 做 的 一 切 。 我 不 确定 没有 你 ,我 们 还 能 不 能 做 到 
这 一 切 。 

















Brian Ketelsen 





首先 要 感谢 我 的 家 人 在 我 写 书 的 这 4 年 间 付 出 的 耐心 。Christine 、Nathan 、Lauren 和 Evelyn， 
感谢 你 们 在 游泳 时 放 过 在 旁边 椅子 上 写作 的 我 ， 感 谢 你 们 相信 这 本 书 一 定 会 出 版 。 


Erik St. Martin 


我 要 感谢 我 的 未 婚 麦 Abby 以 及 我 的 3 个 孩子 Halie、Wyatt 和 Allie。 感谢 你 们 对 我 花 大 量 时 
间 写 书 和 组 织 会 议 如 此 耐心 和 理解 。 我 非常 爱 你 们 ， 有 你 们 我 非常 幸运 。 

还 要 感谢 Bil Kennedy 为 本 书 付出 的 巨大 努力 ， 以 及 当 我 们 需要 他 的 帮助 的 时 候 , 他 总 是 立 
刻 想 办 法 组 织 GopherCon 来 满足 我 们 的 要 求 。 还 要 感谢 整个 社区 出 力 评审 并 给 出 一 些 鼓励 的 话 。 














关于 本 书 





Go 是 一 门 开源 的 编程 语言 ， 目 的 在 于 降低 构建 简单 、 可 靠 、 高 效 软 件 的 门槛 。 尽 管 这 门 语 
言 借鉴 了 很 多 其 他 语言 的 思想 ， 但 是 凭借 自身 统一 和 自然 的 表达 ，Go 程序 在 本 质 上 完全 不 同 于 
用 其 他 语言 编写 的 程序 。Go 平衡 了 底层 系统 语言 的 能 力 ,以 及 在 现代 语言 中 所 见 到 的 高 级 特性 。 
你 可 以 依靠 Go 语言 来 构建 一 个 非常 快捷 、 高 性 能 且 有 足够 控制 力 的 编程 环境 。 使 用 Go 语言 ， 
可 以 写 得 更 少 ， 做 得 更 多 。 






























































谁 应 该 读 这 本 书 


本 书 是 写 给 已 经 有 一 定 其 他 语言 编程 经 验 ， 并 且 想 学 习 Go 语言 的 中 级 开发 者 的 。 我 们 写 这 
本 书 的 目的 是 , 为 读者 提供 一 个 专注 、 全 面 且 符合 语言 习惯 的 视角 。 我 们 同时 关注 语言 的 规范 和 
实现 , 涉及 的 内 容 包 括 语法 、 类 型 系统 ， 并 发 、 通 道 、 测 试 以 及 其 他 一 些 主 题 。 我 们 相信 ， 对 于 
刚 开始 学 Go 语言 的 人 ， 以 及 想 要 深入 了 解 这 门 语言 内 部 实现 的 人 来 说 ， 本 书 都 是 极 佳 的 选择 。 






























































章节 速 览 


本 书 由 9 章 组 成 ， 每 章 内 容 简要 描述 如 下 。 

四 第 1 章 快速 介绍 这 门 语言 是 什么 ， 为 什么 要 创造 这 门 语言 ， 以 及 这 门 语言 要 解决 什么 问 
题 。 这 一 章 还 会 简要 介绍 一 些 Go 语言 的 核心 概念 ， 如 并 发 。 

加 第 2 章 引导 你 完成 一 个 完整 的 Go 程序 ， 并 教 你 Go 作为 一 门 编程 语言 必须 提供 的 特性 。 

四 第 3 章 介 绍 打包 的 概念 ， 以 及 搭建 Go 工作 空间 和 开发 环境 的 最 佳 实践 。 这 一 章 还 会 展 
示 如 何 使 用 Go 语言 的 工具 链 ， 包 括 获取 和 构建 代码 。 

加 第 4 章 展示 Go 语言 内 置 的 类 型 ， 即 数组 、 切 片 和 映射 。 还 会 解释 这 些 数据 结构 背后 的 
实现 和 机 制 。 

四 第 5 章 详细 介绍 Go 语言 的 类 型 系统 ， 从 结构 体 类 型 到 具名 类 型 ， 再 到 接口 和 类 型 符 套 。 这 















































过 关于 本 书 





一 章 还 会 展示 如 何 综合 利用 这 些 数据 结构 ， 用 简单 的 方法 来 设计 结构 并 编写 复杂 的 软件 。 

四 第 6 章 深入 展示 Go 调度 器 、 并 发 和 通道 是 如 何 工作 的 。 这 一 章 还 将 介绍 这 个 方面 背后 
的 机 制 。 

国 第 7 章 基 于 第 6 章 的 内 容 ， 展 示 一 些 实际 开发 中 用 到 的 并 发 模式 。 你 会 学 到 为 了 控制 任 
务 如 何 实现 一 个 goroutine 池 ， 以 及 如 何 利 用 池 来 复 用 资源 。 

四 第 8 章 对 标准 库 进 行 探 索 ， 深 入 介绍 3 个 包 ,， 即 1og、json 和 io。 这 一 章 专 门 介绍 这 
3 个 包 之 间 的 某 些 复杂 关系 。 

国 第 9 章 以 如 何 利用 测试 和 基准 测试 框架 来 结束 全 书 。 读 者 会 学 到 如 何 写 单元 测试 、 表 组 
测试 以 及 基准 测试 ， 如 何在 文档 中 增加 示例 ， 以 及 如 何 把 这 些 示 例 当 作 测 试 使 用 。 









































关于 代码 


本 书 中 的 所 有 代码 都 使 用 等 宽 字 体 表 示 ， 以 便 和 周围 的 文字 区 分 开 。 在 很 多 代码 清单 中 , 代 
码 被 注释 是 为 了 说 明 关键 概念 ， 并 且 有 时 在 正文 中 会 用 数字 编号 来 给 出 对 应 代码 的 其 他 信息 。 
本 书 的 源 代码 既 可 以 在 Manning 网 站 (www.manning.com/books/go-in-action ) 上 下 载 "， 也 
可 以 在 GitHub (https://github.com/goinaction/code ) 上 找到 这 些 源 代码 。 























读者 在 线 


购买 本 书后 , 可 以 在 线 访问 由 Manning 出 版 社 提供 的 私有 论坛 。 在 这 个 论坛 上 可 以 对 本 书 做 评论 ， 
咨询 技术 问题 ， 并 得 到 作者 或 其 他 读者 的 帮助 。 通 过 浏览 器 访问 www.manning.com/books/go-in-action 
可 以 访问 并 订阅 这 个 论坛 。 这 个 网 页 还 提供 了 注册 后 如 何 访问 论坛 , 论坛 提供 什么 样 的 帮助 ， 以 
及 论坛 的 行为 准则 等 信息 。 

Manning 向 读者 承诺 提供 一 个 读者 之 间 以 及 读者 和 作者 之 间 交 流 的 场所 。Manning 并 不 承诺 
作者 一 定 会 参与 ， 作 者 参与 论坛 的 行为 完全 出 于 作者 自愿 (没有 报酬 )。 我 们 建议 你 向 作者 提 一 
些 有 挑战 性 的 问题 ， 否 则 可 能 提 不 起 作者 的 兴 

只 要 本 书 未 绝版 ， 作 者 在 线 论 坛 以 及 早期 讨论 的 存档 就 可 以 在 出 版 商 的 网 站 上 获取 到 。 















































关于 作者 


William Kennedy ( @goinggodotnet ) 是 Ardan 工作 室 的 管理 合伙 人 。 这 家 工作 室 位 于 佛 罗 里 
达州 迈阿密 ， 是 一 家 专注 移动 、Web 和 系统 开发 的 公司 。 他 也 是 博客 GoingGo.net 的 作者 ， 迈 阿 
密 Go 聚会 的 组 织 者 。 从 在 培训 公司 Ardan Labs 开始 , 他 就 专注 于 Go 语言 教学 。 无 论 是 在 当地 ， 











Q@ 本 书 源 代码 也 可 以 从 www.epubit.com.cn 本 书 网 页 免费 下 载 。 


还 是 在 线 上 ， 经 常 可 以 在 大 会 或 者 工作 坊 中 看 到 他 的 身影 。 他 总 是 找 时 间 来 帮助 那些 想 获取 Go 
语言 知识 、 撰 写 博客 和 编码 技能 提升 到 更 高 水 平 的 公司 或 个 人 。 

Brian Ketelsen ( @bketelsen ) 是 XOR Data Exchange 的 CIO 和 联合 创始 人 。Brian 也 是 每 年 
Go 语言 大 会 (GohperCon ) 的 合 办 者 ， 同 时 也 是 Gopher Academy 的 创立 者 。 作 为 专注 于 社区 的 
组 织 ，Gopher Academy 一 直 在 促进 Go 语言 的 发 展 和 对 Go 语言 开发 者 的 培训 。Brian 从 2010 年 
就 开始 使 用 Go 语言 。 

Erik St. Martin ( @erikstmartin ) 是 XOR Data Exchange 的 软件 开发 总 监 。 他 所 在 的 公司 专注 
于 大 数据 分 析 ， 最早 在 得 克 萨 斯 州 奥 斯 汀 ， 后 来 搬 到 了 佛罗里达 州 坦 由 湾 。Erik 长 时 间 为 开源 软 
件 及 其 社区 做 贡献 。 他 是 每 年 GopherCon 的 组 织 者 ， 也 是 坦 帕 湾 Go 聚会 的 组 织 者 。 他 非常 热爱 
Go 语言 及 Go 语言 社区 ， 积 极 寻 求 促进 社区 成 长 的 新 方法 。 

































































关于 封面 插 





本 书 封 面 插图 的 标题 为 “来 自 东 印度 的 人 ”。 这 幅 图 选 自 伦敦 的 Thomas Jefferys 的 《A 
Collection of the Dresses of Different Nations, Ancient and Modern 》(4 卷 )， 出 版 于 1757 年 到 1772 
年 之 间 。 书 籍 首 页 说 明了 这 幅 画 的 制作 工艺 是 铜版 雕刻 ， 手 工 上 色 ， 外 层 用 阿拉 伯 胶 做 保护 。 
Thomas Jefferys ( 1719 一 1771 ) 被 称 作 “ 地 理 界 的 乔治 三 世 国 王 ”。 作 为 制图 者 ,他 在 当时 英国 地 
图 商 中 处 于 领先 地 位 。 他 为 政府 和 其 他 官员 雕刻 和 印刷 地 图 , 同时 也 制作 大 量 的 商业 地 图 和 地 图 
册 , 尤其 是 北美 地 图 。 他 作为 地 图 制作 者 的 经 历 ， 点 燃 了 他 收集 各 地 风俗 服饰 的 兴趣 ， 最 终 成 就 
了 这 部 衣着 集 。 

对 遥远 大 陆 的 着 迷 以 及 对 旅行 的 乐趣 ， 是 18 世纪 晚期 才 兴 起 的 现象 。 这 类 收集 品 也 风行 一 
时 ， 向 实地 旅行 家 和 空想 旅行 家 们 介绍 各 地 的 风俗 。Jefferys 的 画集 如 此 多 样 ， 生 动 地 向 我 们 描 
述 了 200 年 前 世界 上 不 同 民族 的 独立 特征 。 从 那 之 后 ,衣着 的 特征 发 生 了 改变 ， 那个 时 代 不 同 地 
区 和 国家 的 多 样 性 ， 也 逐渐 消失 。 现 在 , 很 难 再 通过 本 地 居民 的 服饰 来 区 分 他 们 所 在 的 大 陆 。 也 
许 , 从 乐观 的 方面 看 ， 也许， 从 乐观 的 角度 来 看 ,我 们 用 文化 的 多 样 性 换取 了 更 加 多 样 化 的 个 人 
生活 一 一 当然 也 是 更 加 多 样 化 和 快 节奏 的 科技 生活 。 

在 很 难 将 一 本 计算 机 书 与 男 一 本 区 分 开 的 时 代 , Manning 创造 性 地 将 两 个 世纪 以 前 不 同 地 区 
的 多 样 性 ， 附 着 在 计算 机 行业 的 图 书 封 面 上 ， 借 以 来 赞美 计算 机 行业 的 创造 力 和 进取 精神 也 为 
Jeffreys 的 画 带 来 了 新 的 生命 。 
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第 1 和 章 基于 Go 话 言 的 介绍 





本 章 主要 内 容 
加 ”用 Go 语言 解决 现代 计算 难题 
加 ”使 用 Go 语言 工具 








计算 机 一 直 在 演化 ， 但 是 编程 语言 并 没有 以 同样 的 速度 演化 。 现 在 的 手机 ， 内 置 的 CPU 核 
数 可 能 都 多 于 我 们 使 用 的 第 一 台电 脑 。 高 性 能 服务 器 拥有 64 核 、128 核 ， 甚 至 更 多 核 。 但 是 我 
们 依旧 在 使 用 为 单 核 设 计 的 技术 在 编程 。 

编程 的 技术 同样 在 演化 。 大 部 分 程序 不 再 由 单个 开发 者 来 完成 ， 而 是 由 处 于 不 同时 区 、 不 同 
时 间 段 工作 的 一 组 人 来 完成 。 大 项 目 被 分 解 为 小 项 目 , 指派 给 不 同 的 程序 员 , 程序 员 开 发 完成 后 ， 
再 以 可 以 在 各 个 应 用 程序 中 交叉 使 用 的 库 或 者 包 的 形式 ， 提 交 给 整个 团队 。 

如 今 的 程序 员 和 公司 比 以 往 更 加 信任 开源 软件 的 力量 。Go 语言 是 一 种 让 代码 分 享 更 容易 的 编 
程 语言 。Go 语言 自 带 一 些 工 具 ， 让 使 用 别人 写 的 包 更 容易 ， 并 且 Go 语言 也 让 分 享 自己 写 的 包 
更 容易 。 

在 本 章 中 读者 会 看 到 Go 语言 区 别 于 其 他 编程 语言 的 地 方 。Go 语言 对 传统 的 面向 对 象 开发 
进行 了 重新 思考 ， 并 且 提 供 了 更 高 效 的 复 用 代码 的 手段 。Go 语言 还 让 用 户 能 更 高 效 地 利用 昂贵 
服务 器 上 的 所 有 核心 ， 而 且 它 编译 大 型 项 目的 速度 也 很 快 。 

在 阅读 本 章 时 ， 读 者 会 对 影响 Go 语言 形态 的 很 多 决定 有 一 些 认识 ， 从 它 的 并 发 模型 到 快 如 
闪电 的 编译 器 。 我 们 在 前 言 中 提 到 过 , 这 里 再 强调 一 次 : 这 本 书 是 写 给 已 经 有 一 定 其 他 编程 语言 
经 验 、 想 学 习 Go 语言 的 中 级 开发 者 的 。 本 书 会 提供 一 个 专注 、 全 面 且 符合 习惯 的 视角 。 我 们 同 
时 专注 语言 的 规范 和 实现 ， 涉 及 的 内 容 包括 语法 、Go 语言 的 类 型 系统 、 并 发 、 通 道 、 测 试 以 及 
其 他 一 些 非 常 广泛 的 主题 。 我 们 相信 ， 对 刚 开 始 要 学 习 Go 语言 和 想 要 深入 了 解 语言 内 部 实现 的 
人 来 说 ， 本 书 都 是 最 佳 选择 。 

本 书 示 例 中 的 源 代码 可 以 在 https://github.com/goinaction/code 下 载 。 

我 们 希望 读者 能 认识 到 ，Go 语言 附带 的 工具 可 以 让 开发 人 员 的 生活 变 得 更 简单 。 最 后 ， 读 
者 会 意识 到 为 什么 那么 多 开发 人 员 用 Go 语言 来 构建 自己 的 新 项 目 。 







































































































































































ms 用 如 解决 现代 编程 难题 


Go 语言 开发 团队 花 了 很 长 时 间 来 解决 当今 软件 开发 人 员 面 对 的 问题 。 开 发 人 员 在 为 项 目 选 
择 语言 时 ， 不 得 不 在 快速 开发 和 性 能 之 间 做 出 选择 。C 和 C++ 这 类 语言 提供 了 很 快 的 执行 速度 ， 
而 Ruby 和 Python 这 类 语言 则 擅长 快速 开发 。Go 语言 在 这 两 者 间架 起 了 桥梁 ,不仅 提供 了 高 性 
能 的 语言 ， 同 时 也 让 开发 更 快速 。 

在 探索 Go 语言 的 过 程 中 ,读者 会 看 到 精心 设计 的 特性 以 及 简洁 的 语法 。 作 为 一 门 语言 ，Go 
不 仅 定义 了 能 做 什么 , 还 定义 了 不 能 做 什么 。Go 语言 的 语法 简洁 到 只 有 几 个 关键 字 , 便于 记忆 。 
Go 语言 的 编译 需 速 度 非常 快 ， 有 时 甚至 会 让 人 感觉 不 到 在 编译 。 所 以 ，Go 开发 者 能 显著 减少 等 
待 项 目 构建 的 时 间 。 因 为 Go 语言 内 置 并 发 机 制 ， 所 以 不 用 被 迫使 用 特定 的 线程 库 ， 就 能 让 软件 
扩展 , 使 用 更 多 的 资源 。Go 语言 的 类 型 系统 简单 旦 高 效 ， 不 需要 为 面向 对 象 开 发 付出 额外 的 心 
智 ， 让 开发 者 能 专注 于 代码 复 用 。Go 语言 还 自 带 垃圾 回收 器 ， 不 需要 用 户 自 己 管理 内 存 。 让 我 
们 快速 浏览 一 下 这 些 关 键 特性 。 









































1.1.1 开发 速度 


编译 一 个 大 型 的 C 或 者 C++ 项 目 所 花费 的 时 间 甚 至 比 去 喝 杯 咖啡 的 时 间 还 长 。 图 1-1 是 XKCD 
中 的 一 幅 漫 画 ， 描 述 了 在 办 公 室 里 开小差 的 经 典 借口 。 





程序 员 合理 地 逃避 工作 最 常用 的 借口 : 
“我 的 代码 正在 编译 呢 。” 










“里 ! 回采 工作 1 “ 

















辐 编译 
"好 吧 ， 你 们 继续 。”) 
多 | 


旭 1-1 努力 工作 ? (来 自 XKCD ) 











Go 语言 使 用 了 更 加 智能 的 编译 絮 ， 并 简化 了 解决 依赖 的 算法 ,最终 提供 了 更 快 的 编译 速度 。 
编译 Go 程序 时 ， 编 译 吉 只 会 关注 那些 直接 被 引用 的 库 ， 而 不 是 像 Java、C 和 C++ 那样 ， 要 遍历 
依赖 链 中 所 有 依赖 的 库 。 因 此 ， 很 多 Go 程序 可 以 在 1 秒 内 编译 完 。 在 现代 硬件 上 ， 编 译 整个 Go 














语言 的 源码 树 只 需要 20 秒 。 

因为 没有 从 编译 代码 到 执行 代码 的 中 间 过 程 ， 用 动态 语言 编写 应 用 程序 可 以 快速 看 到 输出 。 
代价 是 , 动态 语言 不 提供 静态 语言 提供 的 类 型 安全 特性 , 不 得 不 经 常用 大 量 的 测试 套件 来 避免 在 
运行 的 时 候 出 现 类 型 错误 这 类 bug。 

想象 一 下 ， 使 用 类 似 JavaScript 这 种 动态 语言 开发 一 个 大 型 应 用 程序 ， 有 一 个 函数 期 望 接 收 
一 个 叫 作 ID 的 字段 。 这 个 参数 应 该 是 整数 ， 是 字符 串 ， 还 是 一 个 UUID? 要 想 知 道 答案 ， 只 能 
去 看 源 代 码 。 可 以 答 试 使 用 一 个 数字 或 者 字符 串 来 执行 这 个 函数 ， 看 看 会 发 生 什 么 。 在 Go 语言 
里 ， 完 全 不 用 为 这 件 事 情操 心 ， 因 为 编译 需 就 能 帮 用 户 捕获 这 种 类 型 错误 。 
























































1.1.2 并 发 


作为 程序 员 , 要 开发 出 能 充分 利用 硬件 资源 的 应 用 程序 是 一 件 很 难 的 事情 。 现代 计算 机 都 拥 
有 多 个 核 , 但 是 大 部 分 编程 语言 都 没有 有 效 的 工具 让 程序 可 以 轻易 利用 这 些 资源 。 这 些 语言 需要 
写 大 量 的 线程 同步 代码 来 利用 多 个 核 ， 很 容易 导致 错误 。 

Go 语言 对 并 发 的 支持 是 这 门 语言 最 重要 的 特性 之 一 。goroutine 很 像 线 程 ， 但 是 它 占用 的 
内 存 远 少 于 线程 ， 使 用 它 需 要 的 代码 更 少 。 通 道 ( channel ) 是 一 种 内 置 的 数据 结构 ， 可 以 让 
用 户 在 不 同 的 goroutine 之 间 同 步 发 送 具 有 类 型 的 消息 。 这 让 编程 模型 更 倾向 于 在 goroutine 
之 间 发 送 消息 ， 而 不 是 让 多 个 goroutine 争夺 同一 个 数据 的 使 用 权 。 让 我 们 看 看 这 些 特性 的 
细节 。 


































































































1. goroutine 


goroutine 是 可 以 与 其 他 goroutine 并 行 执行 的 函数 ， 同 时 也 会 与 主 程序 ( 程序 的 入口 ) 并 行 
执行 。 在 其 他 编程 语言 中 ， 你 需要 用 线程 来 完成 同样 的 事情 ， 而 在 Go 语言 中 会 使 用 同一 个 线程 
来 执行 多 个 goroutine。 例 如 ， 用 户 在 写 一 个 Web 服务器， 和 希望 同时 处 理 不 同 的 Web 请求， 如 果 
使 用 C 或 者 Java， 不 得 不 写 大 量 的 额外 代码 来 使 用 线程 。 在 Go 语言 中 ，nethttp 库 直 接 使 用 了 
内 置 的 goroutine。 每 个 接收 到 的 请 求 都 自动 在 其 自己 的 goroutine 里 处 理 。goroutine 使 用 的 内 存 
比 线程 更 少 ，Go 语言 运行 时 会 自动 在 配置 的 一 组 逻辑 处 理 器 上 调度 执行 goroutine。 每 个 逻辑 处 
理 需 绑 定 到 一 个 操作 系统 线程 上 ( 见 图 1-2 )。 这 让 用 户 的 应 用 程序 执行 效率 更 高 ， 而 开发 工作 量 
显著 减少 。 

如 果 想 在 执行 一 段 代码 的 同时 ,并行 去 做 另外 一 些 事情 ，goroutine 是 很 好 的 选择 。 下 面 是 一 
个 简单 的 例子 : 


func log(msg string) { 
.. 这 里 是 一 些 记录 日 志 的 代码 





















































ea 























} 











// 代码 里 有 些 地 方 检测 到 了 错误 
go log ("发 生 了 可 怕 的 事情 ") 














goroutine goroutine goroutine goroutine goroutine goroutine 


goroutine | | goroutine | | goroutine 


线程 线程 线程 


图 1-2 在 单一 系统 线程 上 执行 多 个 goroutine 



































关键 字 go 是 唯一 需要 去 编写 的 代码 ， 调 度 1og 函数 作为 独立 的 goroutine 去 运行 ， 以 便 与 
其 他 goroutine 并 行 执行 。 这 意味 着 应 用 程序 的 其 余部 分 会 与 记录 日 志 并 行 执行 ， 通 常 这 种 并 行 
能 让 最 终 用 户 觉得 性 能 更 好 。 就 像 之 前 说 的 ，goroutine 占用 的 资源 更 少 , 所 以 常常 能 启动 成 千 上 
万 个 goroutine。 我 们 会 在 第 6 章 更 加 深入 地 探讨 goroutine 和 并 发 。 

2. 通道 

通道 是 一 种 数据 结构 ， 可 以 让 goroutine 之 间 进 行 安全 的 数据 通信 。 通 道 可 以 帮 用 户 避 免 其 
他 语言 里 常见 的 共享 内 存 访问 的 问题 。 

并 发 的 最 难 的 部 分 就 是 要 确保 其 他 并 发 运行 的 进程 、 线 程 或 goroutine 不 会 意外 修改 用 户 的 
数据 。 当 不 同 的 线程 在 没有 同步 保护 的 情况 下 修改 同一 个 数据 时 , 总 会 发 生 灾 难 。 在 其 他 语言 中 ， 
如 果 使 用 全 局 变量 或 者 共享 内 存 ， 必 须 使 用 复杂 的 锁 规则 来 防止 对 同一 个 变量 的 不 同步 修改 。 

为 了 解决 这 个 问题 , 通道 提供 了 一 种 新 模式 ， 从 而 保证 并 发 修改 时 的 数据 安全 。 通道 这 一 模 
式 保证 同一 时 刻 只 会 有 一 个 goroutine 修改 数据 。 通 道 用 于 在 几 个 运行 的 goroutine 之 间 发 送 数据 。 
在 图 1-3 中 可 以 看 到 数据 是 如 何 流动 的 示例 。 想 象 一 个 应 用 程序 ， 有 多 个 进程 需要 顺序 读 取 或 者 
修改 某 个 数据 ， 使 用 goroutine 和 通道 ， 可 以 为 这 个 过 程 建立 安全 的 模型 。 


goroutine 












































goroutine 
goroutine 
通道 通道 


图 1-3 ”使 用 通道 在 goroutine 之 间 安 全 地 发 送 数据 

















1-3 中 有 3 个 goroutine， 还 有 2 个 不 带 缓存 的 通道 。 第 一 个 goroutine 通过 通道 把 数 
据 传 给 已 经 在 等 待 的 第 二 个 goroutine。 在 两 个 goroutine 间 传 输 数 据 是 同步 的 , 一 旦 传输 完 
成 , 两 个 goroutine 都 会 知道 数据 已 经 完成 传输 。 当 第 二 个 goroutine 利用 这 个 数据 完成 其 任 
务 后 ， 将 这 个 数据 传 给 第 三 个 正在 等 待 的 goroutine。 这 次 传输 依旧 是 同步 的 ， 两 个 goroutine 
都 会 确认 数据 传输 完成 。 这 种 在 goroutine 之 间 安 全 传输 数据 的 方法 不 需要 任何 锁 或 者 同步 
机 人 制 。 

需要 强调 的 是 ， 通 道 并 不 提供 跨 goroutine 的 数据 访问 保护 机 制 。 如 果 通 过 通道 传输 数据 的 
一 份 副本 ， 那 么 每 个 goroutine 都 持 有 一 份 副本 ， 各 自 对 自己 的 副本 做 修改 是 安全 的 。 当 传输 的 
是 指向 数据 的 指针 时 ， 如 果 读 和 写 是 由 不 同 的 goroutine 完成 的 ， 每 个 goroutine 依旧 需要 额外 的 
同步 动作 。 























































































































1.1.3 ”Go 语言 的 类 型 系统 


Go 语言 提供 了 灵活 的 、 无 继承 的 类 型 系统 ， 无 需 降低 运行 性 能 就 能 最 大 程度 上 复 用 代码 。 
这 个 类 型 系统 依然 支持 面向 对 象 开 发 , 但 避免 了 传统 面向 对 象 的 问题 。 如 果 你 曾经 在 复杂 的 Java 
和 C++ 程 序 上 花 数 周 时 间 考 虑 如 何 抽象 类 和 接口 ,你 就 能 意识 到 Go 语言 的 类 型 系统 有 多 么 简单 。 
Go 开发 者 使 用 组 合 ( composition ) 设计 模式 ， 只 需 简单 地 将 一 个 类 型 徐 人 到 另 一 个 类 型 ， 就 能 
复 用 所 有 的 功能 。 其 他 语言 也 能 使 用 组 合 , 但 是 不 得 不 和 继承 绑 在 一 起 使 用 , 结果 使 整个 用 法 非 
常 复杂 ， 很 难 使 用 。 在 Go 语言 中 ， 一 个 类 型 由 其 他 更 微小 的 类 型 组 合 而 成 ， 避 免 了 传统 的 基于 
继承 的 模型 。 

另外 ，Goe 语言 还 具有 独特 的 接口 实现 机 制 ， 允 许 用 户 对 行为 进行 建 模 ， 而 不 是 对 类 型 进行 
建 模 。 在 Go 语言 中 ,不 需要 声明 某 个 类 型 实现 了 某 个 接口 ， 编 译 器 会 判断 一 个 类 型 的 实例 是 否 
符合 正在 使 用 的 接口 。Go 标准 库 里 的 很 多 接口 都 非常 简单 ， 只 开放 几 个 函数 。 从 实践 上 讲 ， 尤 
其 对 那些 使 用 类 似 Java 的 面向 对 象 语言 的 人 来 说 ， 需 要 一 些 时 间 才 能 习惯 这 个 特性 。 
























































1. 类 型 简单 


Go 语言 不 仅 有 类 似 int 和 string 这 样 的 内 置 类 型 ， 还 支持 用 户 定义 的 类 型 。 在 Go 语言 
中 ， 用 户 定义 的 类 型 通常 包含 一 组 带 类 型 的 字段 ， 用 于 存储 数据 。Go 语言 的 用 户 定义 的 类 型 看 
起 来 和 C 语言 的 结构 很 像 ， 用 起 来 也 很 相似 。 不 过 Go 语言 的 类 型 可 以 声明 操作 该 类 型 数据 的 方 
法 。 传 统 语言 使 用 继承 来 扩展 结构 Client 继承 自 User，User 继承 自 Entity，Go 语言 与 此 不 同 ， 
Go 开发 者 构建 更 小 的 类 型 一 一 Customer 和 Admin， 然 后 把 这 些小 类 型 组 合成 更 大 的 类 型 。 图 1-4 
展示 了 继承 和 组 合 之 间 的 不 同 。 






































2. G0 接口 对 一 组 行为 建 模 


接口 用 于 描述 类 型 的 行为 。 如 果 一 个 类 型 的 实例 实现 了 一 个 接口 , 意味 着 这 个 实例 可 以 执行 
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一 组 特定 的 行为 。 你 甚至 不 需要 去 声明 这 个 实例 实现 某 个 接口 ， 只 需要 实现 这 组 行为 就 好 。 其 他 
的 语言 把 这 个 特性 叫 作 鸭子 类 型 一 一 如 果 它 叫 起 来 像 鸭 子 ， 那 它 就 可 能 是 只 鸭子 。Go 语言 的 接 
口 也 是 这 么 做 的 。 在 Go 语言 中 ， 如 果 一 个 类 型 实现 了 一 个 接口 的 所 有 方法 ， 那么 这 个 类 型 的 实 
例 就 可 以 存储 在 这 个 接口 类 型 的 实例 中 ， 不 需要 额外 声明 。 
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图 1-4 ”继承 和 组 合 的 对 比 


























在 类 似 Java 这 种 严格 的 面向 对 象 语言 中 ， 所 有 的 设计 都 围绕 接口 展开 。 在 编码 前 ， 用 户 经 
常 不 得 不 思考 一 个 庞大 的 继承 链 。 下 面 是 一 个 Java 接口 的 例子 : 


interface User { 
public void login(); 
public void logout(); 























} 

在 Java 中 要 实现 这 个 接口 ， 要 求 用 户 的 类 必须 满足 User 接口 里 的 所 有 约束 ， 并 且 显 式 声 
明 这 个 类 实现 了 这 个 接口 。 而 Go 语言 的 接口 一 般 只 会 描述 一 个 单一 的 动作 。 在 Go 语言 中 ， 最 
常 使 用 的 接口 之 一 是 io .Reader。 这 个 接口 提供 了 一 个 简单 的 方法 ， 用 来 声明 一 个 类 型 有 数据 
可 以 读 取 。 标 准 库 内 的 其 他 函数 都 能 理解 这 个 接口 。 这 个 接口 的 定义 如 下 : 


type Reader interface { 
Read(p [lbyte) (n int, err error) 












































} 

为 了 实现 io.Reader 这 个 接口 ， 你 只 需要 实现 一 个 Read 方法 ， 这 个 方法 接受 一 个 byte 
切片 ， 返回 一 个 整数 和 可 能 出 现 的 错误 。 

这 和 传统 的 面向 对 象 编程 语言 的 接口 系统 有 本 质 的 区 别 。Go 语言 的 接口 更 小 ， 只 倾向 于 
定义 一 个 单一 的 动作 。 实 际 使 用 中 ， 这 更 有 利于 使 用 组 合 来 复 用 代码 。 用 户 几 乎 可 以 给 所 有 包 
含 数据 的 类 型 实现 io.Reader 接口 ， 然 后 把 这 个 类 型 的 实例 传 给 任意 一 个 知道 如 何 读 取 
io.Readez 的 Go 困 数 。 

Go 语言 的 整个 网 络 库 都 使 用 了 io.Readez 接口 ， 这 样 可 以 将 程序 的 功能 和 不 同 网 络 的 
实现 分 离 。 这 样 的 接口 用 起 来 有 趣 、 优 雅 且 自由 。 文 件 、 缓 冲 区 、 套 接 字 以 及 其 他 的 数据 源 
都 实现 了 io.Reaqet 接口 。 使 用 同一 个 接口 ， 可 以 高 效 地 操作 数据 ， 而 不 用 考虑 到 底数 据 
来 自 哪里 。 



































1.1.4 ”内 存 管理 


不 当 的 内 存 管 理会 导致 程序 山 江 或 者 内 存 汇 漏 ， 甚 至 让 整个 操作 系统 骨 演 。Go 语言 拥有 现 
代 化 的 垃圾 回收 机 制 ， 能 帮 你 解决 这 个 难题 。 在 其 他 系统 语言 (如 C 或 者 C++ ) 中 ,使 用 内 存 
前 要 先 分 配 这 段 内 存 , 而 且 使 用 完毕 后 要 将 其 释放 掉 。 哪 怕 只 做 错 了 一 件 事 ,都 可 能 导致 程序 崩 
淡 或 者 内 存 汇 漏 。 可惜 ,追踪 内 存 是 否 还 被 使 用 本 身 就 是 十 分 艰难 的 事情 ,而 要 想 文 持 多 线程 和 
高 并 发 ， 更 是 让 这 件 事 难 上 加 难 。 虽 然 Go 语言 的 垃圾 回收 会 有 一 些 额 外 的 开销 ， 但 是 编程 时 ， 
能 显著 降低 开发 难度 。Go 语言 把 无 趣 的 内 存 管理 交 给 专业 的 编译 器 去 做 ， 而 让 程序 员 专 注 于 更 
有 趣 的 事情 。 















































ca 你 好 ， 如 


感受 一 门 语言 最 简单 的 方法 就 是 实践 。 让 我 们 看 看 用 Go 语言 如 何 编写 经 典 的 Hello 
World! 应 用 程序 : 

Go 程序 都 组 

织 成 包 。 


Package main 




















import 语句 用 于 导入 外 部 代码 。 标 准 
库 中 的 fmt 包 用 于 格式 化 并 输出 数据 。 














import "fmt" 二 
func main() { 4 像 C 语言 一 样 ，main 也 
fmt.Println("Hello world!") 数 是 程序 执行 的 入口 





} 
运行 这 个 示例 程序 后 会 在 屏幕 上 输出 我 们 熟悉 的 一 句 话 。 但 是 怎么 运行 呢 ?” 无 须 在 机 带 上 安 
装 Go 语言 ， 在 浏览 铝 中 就 可 以 使 用 几乎 所 有 Go 语言 的 功能 。 











介绍 Go Playground 








Go Playground 允许 在 浏览 器 里 编辑 并 运行 Go 语言 代码 。 在 浏览 器 中 打开 http://play.golang.org。 
浏览 器 里 展示 的 代码 是 可 编辑 的 ( 见 图 1-5 )。 点 击 Run， 看 看 会 发 生 什 么 。 

可 以 把 输出 的 问候 文字 改 成 别 的 语言 。 试 着 改动 fmt .Println() 里 面 的 文字 ， 然 后 再 次 点 
击 Run。 











分 享 Go 代码 ”Go 开发 者 使 用 Playground 分 享 他 们 的 想法 ， 测 试 理论 ， 或 者 调试 代码 。 你 也 可 以 
这 么 做 。 每 次 使 用 Playground 创建 一 个 新 程序 之 后 ， 可 以 点 击 Share 得 到 一 个 用 于 分 享 的 网 址 。 任 
何人 都 能 打开 这 个 链接 。 试 试 http:/play.golang.org/p/EWIXicJdmz。 





Bee Co Playground 


EW lO [2| [r+] 倍 play.golang.org cl [@) 
[an :3 
Go Playground Run Format Share DE 


package main 
import "fmt" 


func main() { 
fmt.Printin("Hello, playground") 

















图 1-5 Go Playground 








要 给 想 要 学 习 写 东西 或 者 寻求 帮助 的 同事 或 者 朋友 演示 某 个 想法 时 ，Go Playground 是 非常 
好 的 方式 。 在 Go 语言 的 IRC 频道 、Slack 群 组 、 邮 件 列表 和 Go 开发 者 发 送 的 无 数 邮件 里 ,用户 
都 能 看 到 创建 、 修 改 和 分 享 Go Playground 上 的 程序 。 





cf 小 结 


国 Go 语言 是 现代 的 、 快 速 的 ， 带 有 一 个 强大 的 标准 库 。 
加 Go 语言 内 置 对 并 发 的 支持 。 
四 ”Go 语言 使 用 接口 作为 代码 复 用 的 基础 模块 。 


第 2 重 快速 开始 一 个 Go 程序 





本 章 主要 内 容 

学 习 如 何 写 一 个 复杂 的 Go 程序 
声明 类 型 、 变 量 、 函 数 和 方法 
启动 并 同步 操作 goroutine 

使 用 接口 写 通 用 的 代码 

处 理 程序 逻辑 和 错误 








为 了 能 更 高 效 地 使 用 语言 进行 编码 ,Go 语言 有 自己 的 哲学 和 编程 习惯 。Go 语言 的 设计 者 们 
从 编程 效率 出 发 设计 了 这 门 语言 , 但 又 不 会 丢掉 访问 底层 程序 结构 的 能 力 。 设计 者 们 通过 一 组 最 
少 的 关键 字 、 内 置 的 方法 和 语法 ， 最 终 平衡 了 这 两 方面 。Go 语言 也 提供 了 完善 的 标准 库 。 标 准 
库 提 供 了 构建 实际 的 基于 Web 和 基于 网 络 的 程序 所 需 的 所 有 核心 库 。 

让 我 们 通过 一 个 完整 的 Go 语言 程序 ， 来 看 看 Go 语言 是 如 何 实现 这 些 功能 的 。 这 个 程序 实 
现 的 功能 很 常见 ， 能 在 很 多 现在 开发 的 Go 程序 里 发 现 类 似 的 功能 。 这 个 程序 从 不 同 的 数据 源 拉 
取 数 据 , 将 数据 内 容 与 一 组 搜索 项 做 对 比 ， 然 后 将 匹配 的 内 容 显示 在 终端 窗口 。 这 个 程序 会 读 取 
文本 文件 ， 进 行 网 络 调用 ， 解 码 XML 和 JSON 成 为 结构 化 类 型 数据 ， 并 且 利 用 Go 语言 的 并 发 



























































机 制 保证 这 些 操 作 的 速度 。 









































读者 可 以 下 载 本 章 的 代码 ， 用 自己 喜欢 的 编辑 器 阅读 。 代 码 存放 在 这 个 代码 库 : 


https://github.com/goinaction/code/tree/master/chapter2/sample 


























没 必要 第 一 次 就 读 懂 本 童 的 所 有 内 容 ， 可 以 多 读 两 帝 。 在 学 习 时 , 虽然 很 多 现代 语言 的 概念 








可 以 对 应 到 Go 语言 中 ，Go 语言 还 是 有 一 些 独特 的 特 怕 


用 一 种 全 新 的 眼光 来 审视 Go 语言 ， 你 会 更 容易 理解 并 接受 Go 语言 的 特性 ， 发现 Go 语言 的 优雅 。 





。29 程序 架构 





E 和 风格 。 如 细 





放下 已 经 熟悉 的 编程 语言 ， 





























在 深入 代码 之 前 ， 让 我 们 看 一 下 程序 的 架构 ( 如 图 2-1 所 示 )， 看 看 如 何在 所 有 不 同 的 数据 





源 中 搜索 数据 。 





图 2-1 程序 架构 流程 图 














这 个 程序 分 成 多 个 不 同步 又 ,在 多 个 不 同 的 goroutine 里 运行 。 我 们 会 根据 流程 展示 代码 ， 
从 主 goroutine 开始 ， 一 直到 执行 搜索 的 goroutine 和 跟踪 结果 的 goroutine， 最 后 回 到 主 goroutine。 
首先 来 看 一 下 整个 项 目的 结构 ， 如 代码 清单 2-1 所 示 。 


代码 清单 2-1 ”应 用 程序 的 项 目 结构 


cd $GOPATH/src/github.com/goinaction/code/chapter2 























- sample 

-data 
data.json ”-- 包含 一 组 数据 源 

—- matchers 
rss.go -- 搜索 rss 源 的 匹配 器 

— search 
default .go  -- 搜索 数据 用 的 默认 匹配 器 
feed.go -- 用 于 读 取 json 数据 文件 
match.go -- 用 于 支持 不 同 匹 配器 的 接口 
search.go ”-- 执行 搜索 的 主 控 制 逻 辑 

main.go -- 程序 的 入 口 


这 个 应 用 的 代码 使 用 了 4 个 文件 夹 , 按 字母 顺序 列 出 。 文 件 夹 data 中 有 一 个 JSON 文档 , 其 
内 容 是 程序 要 拉 取 和 处 理 的 数据 源 。 文 件 夹 matchers 中 包含 程序 里 用 于 支持 搜索 不 同 数 据 源 的 代 
码 。 目 前 程序 只 完成 了 支持 处 理 RSS 类 型 的 数据 源 的 匹配 器 。 文 件 夹 search 中 包含 使 用 不 同 匹 
配器 进行 搜索 的 业务 逻辑 。 最 后 ， 父 级 文件 夹 sample 中 有 个 main.go 文件 ， 这 是 整个 程序 的 人 口 。 

现在 了 解 了 如 何 组 织 程序 的 代码 , 可 以 继续 探索 并 了 解 程序 是 如 何 工 作 的 。 让 我 们 从 程序 的 
入 口 开始 。 




















ea main 包 


程序 的 主 和 人口 可 以 在 main.go 文件 里 找到 , 如 代码 清单 2-2 所 示 。 虽 然 这 个 文件 只 有 21 行 代 
码 ， 依 然 有 几 点 需要 注意 。 


代码 清单 2-2 main.go 


01 Package main 


03 import ( 
04 Tog” 
05 VOs™ 


07 _ "github.com/goinaction/code/chapter2/sample/matchers" 
08 "github.com/goinaction/code/chapter2/sample/search" 
09 ) 








// init 在 main 之 前 调用 
func init() { 

// 将 日 志 输 出 到 标准 输出 
log.SetOutput (os.Stdout) 





// main 是 整个 程序 的 入 口 

func main() { 

1 // 使 用 特定 的 项 做 搜索 

20 search.Run ("president") 
Ey 


每 个 可 执行 的 Go 程序 都 有 两 个 明显 的 特征 。 一 个 特征 是 第 18 行 声明 的 名 为 main 的 函数 。 
构建 程序 在 构建 可 执行 文件 时 ， 需 要 找到 这 个 已 经 声明 的 main 函数 ， 把 它 作为 程序 的 入 口 。 第 
二 个 特征 是 程序 的 第 01 行 的 包 名 main， 如 代码 清单 2-3 所 示 。 
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代码 清单 2-3 main.go: 第 01 行 


01 package main 


可 以 看 到 ，main 函数 保存 在 名 为 main 的 包 里 。 如 果 main 函数 不 在 main 包 里 ,构建 工 
具 就 不 会 生成 可 执行 的 文件 。 

Go 语言 的 每 个 代码 文件 都 属于 一 个 包 ，main.go 也 不 例外 。 包 这 个 特性 对 于 Go 语言 来 说 很 
重要 ,我 们 会 在 第 3 章 中 接触 到 更 多 细节 。 现在， 只 要 简单 了 解 以 下 内 容 : 一 个 包 定义 一 组 编译 
过 的 代码 , 包 的 名 字 类 似 命 名 空间 ， 可 以 用 来 间接 访问 包 内 声明 的 标识 符 。 这 个 特性 可 以 把 不 同 
包 中 定义 的 同名 标识 符 区 别 开 。 

现在 ， 把 注意 力 转 到 main.go 的 第 03 行 到 第 09 行 ， 如 代码 清单 2-4 所 示 ， 这 里 声明 了 所 有 
的 导入 项 。 











代码 清单 2-4 main.go: 第 03 行 到 第 09 行 





03 import ( 
04 Tog™ 
05 Vos"™ 


07 _ "github.com/goinaction/code/chapter2/sample/matchers" 
08 "github.com/goinaction/code/chapter2/sample/search" 





顾名思义 ， 关 键 字 import 就 是 导入 一 段 代码 ,让 用 户 可 以 访问 其 中 的 标识 符 ， 如 类 型 、 扬 
数 、 常 量 和 接口 。 在 这 个 例子 中 ， 由 于 第 08 行 的 导入 ，main.go 里 的 代码 就 可 以 引用 search 
包 里 的 Run 函数 。 程 序 的 第 04 行 和 第 05 行 导入 标准 库 里 的 1og 和 os 包 。 

所 有 处 于 同一 个 文件 夹 里 的 代码 文件 ， 必 须 使 用 同一 个 包 名 。 按 照 惯例 ， 包 和 文件 夹 
同名 。 就 像 之 前 说 的 ， 一 个 包 定 义 一 组 编译 后 的 代码 ， 每 段 代 码 都 描述 包 的 一 部 分 。 如 果 
回头 去 看 看 代码 清单 2-1， 可 以 看 看 第 08 行 的 导 和 是 如 何 指定 那个 项 目 里 名 叫 search 的 
文件 夹 的 。 

读者 可 能 注意 到 第 07 行 导 入 matchers 包 的 时 候 ， 导 入 的 路 径 前 面 有 一 个 下 划 线 ， 如 代码 
清单 2-5 所 示 。 


代码 清单 2-5 main.go: 第 07 行 





QO _ "github.com/goinaction/code/chapter2/sample/matchers" 


这 个 技术 是 为 了 让 Go 语言 对 包 做 初始 化 操作 ,但 是 并 不 使 用 包 里 的 标识 符 。 为 了 让 程序 的 
可 读 性 更 强 ，Go 编译 器 不 允许 声明 导入 某 个 包 却 不 使 用 。 下 划 线 让 编译 器 接受 这 类 导 人 和 人， 并 且 
调用 对 应 包 内 的 所 有 代码 文件 里 定义 的 init 函数 。 对 这 个 程序 来 说 ， 这 样 做 的 目的 是 调用 
matchers 包 中 的 rss.go 代码 文件 里 的 init 函数 , 注册 RSS 匹配 絮 , 以 便 后 用 。 我 们 后 面 会 展 
示 具 体 的 工作 方式 。 

代码 文件 main.go 里 也 有 一 个 init 函数 ， 在 第 12 行 到 第 15 行 中 声明 ， 如 代码 清单 2-6 所 示 。 























代码 清单 2-6 main.go: 第 11 行 到 第 15 行 








11 // init 在 main 之 前 调用 
12 func init () { 

13 // 将 日 志 输 出 到 标准 输出 

14 log.SetOutput (os.Stdout) 
15 


程序 中 每 个 代码 文件 里 的 init 函数 都 会 在 main 函数 执行 前 调用 ,这 个 init 函数 将 标准 库 
里 日 志 类 的 输出 ， 从 默认 的 标准 错误 (stderr ), 设置 为 标准 输出 (stdout ) 设备 。 在 第 7 章 ， 
我 们 会 进一步 讨论 1og 包 和 标准 库 里 其 他 重要 的 包 。 

最 后 ， 让 我 们 看 看 main 函数 第 20 行 那 条 语句 的 作用 ， 如 代码 清单 2-7 所 示 。 











代码 清单 2-7 main.go: 第 19 行 到 第 20 行 
19 // 使 用 特定 的 项 做 搜索 


20 Search.Run ("Presidqent") 




















可 以 看 到 ， 这 一 行 调用 了 search 包 里 的 Run 函数 。 这 个 函数 包含 程序 的 核心 业务 逻辑 ， 
需要 传人 一 个 字符 串 作 为 搜索 项 。 一 旦 Run 函数 退出 ， 程 序 就 会 终止 。 
现在 ， 让 我 们 看 看 search 包 里 的 代码 。 


eX search 包 


这 个 程序 使 用 的 框架 和 业务 逻辑 都 在 search 包 里 。 这 个 包 由 4 个 不 同 的 代码 文件 组 成 ， 
每 个 文件 对 应 一 个 独立 的 职责 。 我 们 会 逐步 分 析 这 个 程序 的 逻辑 ， 到 时 再 说 明 各 个 代码 文件 的 
作用 。 

由 于 整个 程序 都 围绕 匹配 器 来 运作 , 我 们 先 简单 介绍 一 下 什么 是 匹配 器 。 这 个 程序 里 的 匹配 
器 ,是 指 包含 特定 信息 、 用 于 处 理 某 类 数据 源 的 实例 。 在 这 个 示例 程序 中 有 两 个 无 配器。 框架 本 
身 实现 了 一 个 无 法 获取 任何 信息 的 默认 匹配 器 ， 而 在 matchers 包 里 实现 了 RSS 匹配 器 。RSS 
匹配 器 知道 如 何 获取 、 读 人 并 查找 RSS 数据 源 。 随 后 我 们 会 扩展 这 个 程序 ， 加 入 能 读 取 JSON 
文档 或 CSV 文件 的 匹配 器 。 我 们 后 面 会 再 讨论 如 何 实现 匹配 器 。 














2.3.1 Search.go 


代码 清单 2-8 中 展示 的 是 search.go 代码 文件 的 前 9 行 代码 。 之 前 提 到 的 Run 函数 就 在 这 个 
文件 里 。 





代码 清单 2-8 search/search.go: 第 01 行 到 第 09 行 


01 Package search 


02 

03 import '( 
04 TEog” 
05 "sync" 
06 ) 

07 


08 // 注册 用 于 搜索 的 匹配 器 的 映射 

09 var matchers = make (map[string]Matcher) 

可 以 看 到 , 每 个 代码 文件 都 以 Package 关键 字 开 头 , 随后 跟着 包 的 名 字 。 文件 夹 search 下 的 
每 个 代码 文件 都 使 用 search 作为 包 名 。 第 03 行 到 第 06 行 代码 导入 标准 库 的 1og 和 sync 包 。 

与 第 三 方 包 不 同 , 从 标准 库 中 导入 代码 时 , 只 需要 给 出 要 导入 的 包 名 。 编译 器 查找 包 的 时 候 ， 
总 是 会 到 GOROOT 和 GOPATH 环境 变量 (如 代码 清单 2-9 所 示 ) 引用 的 位 置 去 查找 。 

















代码 清单 2-9 GoRooT 和 GOPATH 环境 变量 


GOROOT="/Users/me/go" 
GOPATH="/Users/me/spaces/go/projects" 


1og 包 提 供 打 印 日 志 信息 到 标准 输出 〈stdqout )、 标 准 错误 ( stqerr ) 或 者 自 定义 设备 的 
功能 。sync 包 提 供 同 步 goroutine 的 功能 。 这 个 示例 程序 需要 用 到 同步 功能 。 第 09 行 是 全 书 第 
一 次 声明 一 个 变量 ， 如 代码 清单 2-10 所 示 。 





代码 清单 2-10 search/search.go: 第 08 行 到 第 09 行 











08 // 注册 用 于 搜索 的 匹配 器 的 映射 


09 var matchers = make (map[string]Matcher) 

这 个 变量 没有 定义 在 任何 函数 作用 域内 , 所 以 会 被 当成 包 级 变量 。 这 个 变量 使 用 关键 字 var 
声明 , 而 且 声 明 为 Matcher 类 型 的 映射 (map ), 这 个 映射 以 string 类 型 值 作为 键 , Mat cher 
类 型 值 作为 映射 后 的 值 。Matcher 类 型 在 代码 文件 matcher.go 中 声明 ， 后 面 再 讲 这 个 类 型 的 用 
途 。 这 个 变量 声明 还 有 一 个 地 方 要 强调 一 下 : 变量 名 matchers 是 以 小 写字 母 开头 的 。 

在 Go 语言 里 ,标识 符 要 么 从 包 里 公开 ,要么 不 从 包 里 公开 。 当 代码 导入 了 一 个 包 时 ,程序 
可 以 直接 访问 这 个 包 中 任意 一 个 公开 的 标识 符 。 这 些 标识 符 以 大 写字 母 开头 。 以 小 写字 母 开头 的 
标识 符 是 不 公开 的 , 不 能 被 其 他 包 中 的 代码 直接 访问 。 但 是 , 其 他 包 可 以 间接 访问 不 公开 的 标识 
符 。 例 如 , 一 个 函数 可 以 返回 一 个 未 公开 类 型 的 值 , 那么 这 个 函数 的 任何 调用 者 ， 哪 怕 调 用 者 不 
是 在 这 个 包 里 声明 的 ， 都 可 以 访问 这 个 值 。 

这 行 变 量 声 明 还 使 用 赋值 运算 符 和 特殊 的 内 置 函数 make 初始 化 了 变量 , 如 代码 清单 2-11 所 示 。 


make (map [string] Matcher) 

map 是 Go 语言 里 的 一 个 引用 类 型 , 需要 使 用 make 来 构造 。 如 果 不 先 构 造 map 并 将 构造 后 
的 值 赋值 给 变量 ,会 在 试图 使 用 这 个 map 变量 时 收 到 出 错 信 息 。 这 是 因为 map 变量 默认 的 零 值 
是 nil。 在 第 4 章 我 们 会 进一步 了 解 关于 映射 的 细节 。 

在 Go 语言 中 , 所 有 变量 都 被 初始 化 为 其 零 值 。 对 于 数值 类 型 ， 零 值 是 0; 对 于 字符 串 类 型 ， 
零 值 是 空 字符 串 ; 对 于 布尔 类 型 ， 零 值 是 false; 对 于 指针 ， 零 值 是 ni1。 对 于 引用 类 型 来 说 ， 
所 引用 的 底层 数据 结构 会 被 初始 化 为 对 应 的 零 值 。 但 是 被 声明 为 其 零 值 的 引用 类 型 的 变量 , 会 返 
回 nil 作为 其 值 。 

现在 ， 让 我 们 看 看 之 前 在 main 兄 数 中 调用 的 Run 函数 的 内 容 ， 如 代码 清单 2-12 所 示 。 































































































代码 清单 2-12 search/search.go: 第 11 行 到 第 57 行 


11 // Run 执行 搜索 逻辑 
12 func Run(searchTerm string) { 
13 // 获取 需要 搜索 的 数据 源 列 表 


14 feeds, err := RetrieveFeeds() 





ED if err != nil { 























16 log.Fatal (err) 

dF } 

18 

19 // 创建 一 个 无 缓冲 的 通道 ， 接 收 匹配 后 的 结果 
20 results := make (chan *Result) 

之 于 

22 // 构造 一 个 waitGroup， 以 便 处 理 所 有 的 数据 源 
23 Var waitGroup sync.WaitGroup 

24 


25 // 设置 需要 等 待 处 理 
26 // 每 个 数据 源 的 goroutine 的 数量 





































































































2 waitGroup.Add (len (feeds)) 

28 

29 // 为 每 个 数据 源 启动 一 个 goroutine 来 查找 结果 

30 for , feed := range feeds { 

3 // 获取 一 个 匹配 器 用 于 查找 

3 之 matcher, exists := matchers [feed.Typel 
33 if lexists { 

34 matcher = matchers["default"] 

35 } 

36 

3 了 // 启动 一 个 goroutine 来 执行 搜索 

38 go func (matcher Matcher, feed *Feed) { 
39 Match (matcher, feed, searchTerm, results) 
40 waitGroup.Done () 

41 } (matcher, feed) 

42 } 

43 

44 // 启动 一 个 goroutine 来 监控 是 否 所 有 的 工作 都 做 完 ] 
45 go func() { 

46 // 等 候 所 有 任务 完成 

47 waitGroup.Wait () 

48 

49 // 用 关闭 通道 的 方式 ， 通 知 Display 函数 

50 // 可 以 退出 程序 了 

3 close (results) 

52 }() 

53 

54 // 启动 函数 ， 显 示 返 回 的 结果 ， 并 目 

55 // 在 最 后 一 个 结果 显示 完 后 返回 

56 Display (results) 

57 } 


Run 函数 包括 了 这 个 程序 最 主要 的 控制 逻辑 。 这 段 代 码 很 好 地 展示 了 如 何 组 织 Go 程序 的 代码 ， 
以 便 正确 地 并 发 启动 和 同步 goroutine。 先 来 一 步 一 步 考察 整个 逻辑 ， 再 考察 每 步 实 现代 码 的 细节 。 
先 来 看 看 Run 函数 是 怎么 定义 的 ， 如 代码 清单 2-13 所 示 。 





代码 清单 2-13 ”search/search.go: 第 11 行 到 第 12 行 


11 // Run 执行 搜索 逻辑 


12 func Run(searchTerm string) { 








Go 语言 使 用 关键 字 func 声明 函数 , 关键 字 后 面 紧 跟 着 函数 名 、 参 数 以 及 返回 值 。 对 于 Run 
这 个 函数 来 说 ， 只 有 一 个 参数 ， 是 string 类 型 的 ， 名 叫 searchTerm。 这 个 参数 是 Run 函数 
要 搜索 的 搜索 项 ， 如 果 回 头 看 看 main 函数 ( 如 代码 清单 2-14 所 示 )， 可 以 看 到 如 何 传递 这 个 搜 
索 项 。 








代码 清单 2-14 main.go: 第 17 行 到 第 21 行 


17 // main 是 整个 程序 的 入 口 
18 func main() { 








19 // 使 用 特定 的 项 做 搜索 
20 Search.Run ("Presidqent") 
让 


Run 函数 做 的 第 一 件 事情 就 是 获取 数据 源 feeds 列表 。 这 些 数据 源 从 互联 网 上 抓 取 数 据 ， 
之 后 对 数据 使 用 特定 的 搜索 项 进行 匹配 ， 如 代码 清单 2-15 所 示 。 

















13 // 获取 需要 搜索 的 数据 源 列 表 


14 feeds, err := RetrieveFeeds() 
2 if err != nil { 

16 log.Fatal (err) 

bh } 


这 里 有 几 个 值得 注意 的 重要 概念 。 第 14 行 调用 了 search 包 的 RetrieveFeeds 因数 。 
这 个 函数 返回 两 个 值 。 第 一 个 返回 值 是 一 组 Feed 类 型 的 切片 。 切 片 是 一 种 实现 了 一 个 动态 数 
组 的 引用 类 型 。 在 Go 语言 里 可 以 用 切片 来 操作 一 组 数据 。 第 4 章 会 进一步 深入 了 解 有 关切 片 
的 细节 。 

第 二 个 返回 值 是 一 个 错误 值 。 在 第 15 行 ， 检 查 返 回 的 值 是 不 是 真 的 是 一 个 错误 。 如 果真 的 
发 生 错误 了 ， 就 会 调用 1og 包 里 的 Fatal 函数 。Fatal 函数 接受 这 个 错误 的 值 ,并 将 这 个 错误 
在 终端 窗口 里 输出 ， 随 后 终止 程序 。 

不 仅仅 是 Go 语言 , 很 多 语言 都 允许 一 个 函数 返回 多 个 值 。 一 般 会 像 RetrieveFeeds 困 数 这 
样 声明 一 个 函数 返回 一 个 值 和 一 个 错误 值 。 如 果 发 生 了 错误 , 永远 不 要 使 用 该 函数 返回 的 男 一 个 
值 "”。 这 时 必须 忽略 另 一 个 值 ， 和 否则 程序 会 产生 更 多 的 错误 ， 甚 至 表演。 

让 我 们 仔细 看 看 从 函数 返回 的 值 是 如 何 赋值 给 变量 的 ， 如 代码 清单 2-16 所 示 。 





代码 清单 2-16 search/search.go: 第 13 行 到 第 14 行 
13 // 获取 需要 搜索 的 数据 源 列 表 


14 feeds, err := RetrieveFeeds() 


这 里 可 以 看 到 简化 变量 声明 运算 符 ( := )。 这 个 运算 符 用 于 声明 一 个 变量 ， 同 时 给 这 个 变量 





@ 这 个 说 法 并 不 严格 成 立 ，Go 标准 库 中 的 io.ReaderRead 方法 就 允许 同时 返回 数据 和 错误 。 但 是 ， 如 果 是 
自己 实现 的 函数 ， 要 尽量 遵守 这 个 原则 ， 保 持 含义 足够 明确 。 一 一 译 者 注 





赋予 初始 值 。 编译 器 使 用 西数 返回 什 的 类 型 来 确定 每 个 变量 的 类 型 。 简 化 变量 声明 运算 符 只 是 一 
种 简化 记 法 ， 让 代码 可 读 性 更 高 。 这 个 运算 符 声明 的 变量 和 其 他 使 用 关键 字 var 声明 的 变量 没 
有 任何 区 别 。 

现在 我 们 得 到 了 数据 源 列表 ， 进 入 到 后 面 的 代码 ， 如 代码 清单 2-17 所 示 。 





代码 清单 2-17 search/search.go: 第 19 行 到 第 20 行 








19 // 创建 一 个 无 缓冲 的 通道 ， 接 收 匹配 后 的 结果 

20 results := make (chan *Result) 

在 第 20 行 ， 我们 使 用 内 置 的 make 函数 创建 了 一 个 无 缓冲 的 通道 。 我 们 使 用 简化 变量 声明 
运算 符 , 在 调用 make 的 同时 声明 并 初始 化 该 通道 变量 。 根 据 经 验 ， 如 果 需 要 声明 初始 值 为 零 值 
的 变量 ， 应 该 使 用 var 关键 字 声 明 变 量 ; 如 果 提 供 确切 的 非 零 值 初始 化 变量 或 者 使 用 函数 返回 
值 创建 变量 ， 应 该 使 用 简化 变量 声明 运算 符 。 

在 Go 语言 中 ， 通 道 (channel ) 和 映射 ( map ) 与 切片 (slice ) 一 样 ， 也 是 引用 类 型 ， 不 过 
通道 本 身 实现 的 是 一 组 带 类 型 的 值 ， 这 组 值 用 于 在 goroutine 之 间 传 递 数 据 。 通 道内 置 同步 机 制 ， 
从 而 保证 通信 和 安全。 在 第 6 章 中 ， 我 们 会 介绍 更 多 关于 通道 和 goroutine 的 细节 。 

之 后 两 行 是 为 了 防止 程序 在 全 部 搜索 执行 完 之 前 终止 ， 如 代码 清单 2-18 所 示 。 











代码 清单 2-18 search/search.go: 第 22 行 到 第 27 行 








22 // 构造 一 个 wait group， 以 便 处 理 所 有 的 数据 源 


分 Var waitGroup sync.WaitGroup 


25 // 设置 需要 等 待 处 理 

26 // 每 个 数据 源 的 goroutine 的 数量 

27 waitGroup.Add (len (feeds)) 

在 Go 语言 中 ,如 果 main 函数 返回 ， 整个 程序 也 就 终止 了 。Go 程序 终止 时 , 还 会 关闭 所 有 
之 前 启动 且 还 在 运行 的 goroutine。 写 并 发 程序 的 时 候 ， 最 佳 做 法 是 , 在 main 函数 返回 前 ,清理 
并 终止 所 有 之 前 启动 的 goroutine。 编 写 启动 和 终止 时 的 状态 都 很 清晰 的 程序 ， 有 助 减少 bug， 防 
止 资源 异常 。 

这 个 程序 使 用 sync 包 的 WaitGroup 跟踪 所 有 启动 的 goroutine。 非 常 推荐 使 用 WaitGroup 来 
跟踪 goroutine 的 工作 是 否 完成 。 WaitGroup 是 一 个 计数 信号 量 , 我 们 可 以 利用 它 来 统计 所 有 的 
goroutine 是 不 是 都 完成 了 工作 。 

在 第 23 行 我 们 声明 了 一 个 sync 包 里 的 waitGroup 类 型 的 变量 。 之 后 在 第 27 行 , 我 们 将 
WaitGroup 变量 的 值 设置 为 将 要 启动 的 goroutine 的 数量 。 马 上 就 能 看 到 , 我 们 为 每 个 数据 源 都 
启动 了 一 个 goroutine 来 处 理 数据 。 每 个 goroutine 完成 其 工作 后 ， 就 会 递减 waitGroup 变量 的 
计数 值 ， 当 这 个 值 递减 到 0 时 ， 我 们 就 知道 所 有 的 工作 都 做 完了 。 

现在 让 我 们 来 看 看 为 每 个 数据 源 启 动 goroutine 的 代码 ， 如 代码 清单 2-19 所 示 。 




















代码 清单 2-19 search/search.go: 第 29 行 到 第 42 行 


29 // 为 每 个 数据 源 启 动 一 个 goroutine 来 查找 结果 


























30 for , feed := range feeds { 

31 // 获取 一 个 匹配 器 用 于 查找 

32 matcher, exists := matchers [feed.Typel] 
SS if !exists { 

34 matcher = matchers["default"] 

23 } 

36 

37 // 启动 一 个 goroutine 来 执行 搜索 

8 go func (matcher Matcher, feed *Feed) { 
39 Match (matcher, feed, searchTerm, results) 
40 waitGroup.Done () 

41 } (matcher, feed) 

42 } 


第 30 行 到 第 42 行 迭 代 之 前 获得 的 feeds ， 为 每 个 feed 启动 一 个 goroutine。 我 们 使 用 关 
键 字 for range 对 feeds 切片 做 迭代 。 关 键 字 range 可 以 用 于 友 代 数组 、 字 符 串 、 切 片 、 映 
射 和 通道 。 使 用 for range 迭代 切片 时 ， 每 次 迁 代 会 返回 两 个 值 。 第 一 个 值 是 欠 代 的 元 素 在 切 
片 里 的 索引 位 置 ， 第 二 个 值 是 元 素 值 的 一 个 副本 。 

如 果 仔 细 看 一 下 第 30 行 的 for range 语句 ， 会 发 现 再 次 使 用 了 下 划 线 标识 符 ， 如 代码 清 
单 2-20 所 示 。 








代码 清单 2-20 search/search.go: 第 29 行 到 第 30 行 


29 // 为 每 个 数据 源 启动 一 个 goroutine 来 查找 结果 

30 for , feed := range feeds { 

这 是 第 二 次 看 到 使 用 了 下 划 线 标识 符 。 第 一 次 是 在 main.go 里 导入 matchers 包 的 时 候 。 这 
次 ， 下 划 线 标识 符 的 作用 是 占 位 符 ， 占 据 了 保存 range 调用 返回 的 索引 值 的 变量 的 位 置 。 如 果 
要 调用 的 函数 返回 多 个 值 ， 而 又 不 需要 其 中 的 某 个 值 ， 就 可 以 使 用 下 划 线 标识 符 将 其 忽略 。 在 我 
们 的 例子 里 ， 我 们 不 需要 使 用 返回 的 索引 值 ， 所 以 就 使 用 下 划 线 标识 符 把 它 忽略 掉 。 

在 循环 中 ,我 们 首先 通过 map 查找 到 一 个 可 用 于 处 理 特定 数据 源 类 型 的 数据 的 Mat cher 值 ， 
如 代码 清单 2-21 所 示 。 





代码 清单 2-21 search/search.go: 第 31 行 到 第 35 行 








31 // 获取 一 个 匹配 器 用 于 查找 

3 matcher, exists := matchers [feed.Typel 
33 if lexists { 

34 matcher = matchers["default"] 

35 } 


我 们 还 没有 说 过 map 里 面 的 值 是 如 何 获得 的 。 一 会 儿 就 会 在 程序 初始 化 的 时 候 看 到 如 何 设 
置 map 里 的 值 。 在 第 32 行 ,我们 检查 map 是 否 含 有 符合 数据 源 类 型 的 值 。 查 找 map 里 的 键 时 ， 





有 两 个 选择 : 要 么 赋值 给 一 个 变量 ， 要 么 为 了 精确 查找 ， 赋 值 给 两 个 变量 。 赋 值 给 两 个 变量 时 第 
一 个 值 和 赋值 给 一 个 变量 时 的 值 一 样 ， 是 map 查找 的 结果 值 。 如 果 指 定 了 第 二 个 值 ， 就 会 返回 
一 个 布尔 标志 ， 来 表示 查找 的 键 是 否 存在 于 map 里 。 如 果 这 个 键 不 存在 ，map 会 返回 其 值 类 型 
的 零 值 作为 返回 值 ， 如 果 这 个 键 存在 ，map 会 返回 键 所 对 应 值 的 副本 。 

在 第 33 行 ， 我 们 检查 这 个 键 是 否 存在 于 map 里 。 如 果 不 存 在 ， 使 用 默认 匹配 器 。 这 样 程序 
在 不 知道 对 应 数据 源 的 具体 类 型 时 ， 也 可 以 执行 ， 而 不 会 中 断 。 之 后 ， 启 动 一 个 goroutine 来 执 
行 搜索 ， 如 代码 清单 2.22 所 示 。 








代码 清单 2-22 search/search.go: 第 37 行 到 第 41 行 








3 // 启动 一 个 goroutine 来 执行 搜索 

38 go func (matcher Matcher, feed *Feed) { 

39 Match (matcher, feed, searchTerm, results) 
40 waitGroup.Done () 

41 } (matcher, feed) 


我 们 会 在 第 6 章 进 一 步 学 习 goroutine， 现 在 只 要 知道 ， 一 个 goroutine 是 一 个 独立 于 其 他 函 
数 运行 的 孔 数 。 使 用 关键 字 go 启动 一 个 goroutine, 并 对 这 个 goroutine 做 并 发 调度 。 在 第 38 行 ， 
我 们 使 用 关键 字 go 启动 了 一 个 匿名 函数 作为 goroutine。 匿 名 地 数 是 指 没有 明确 声明 名 字 的 函 
数 。 在 for range 循环 里 ， 我 们 为 每 个 数据 源 ， 以 goroutine 的 方式 启动 了 一 个 匿名 函数 。 这 
样 可 以 并 发 地 独立 处 理 每 个 数据 源 的 数据 。 

匿名 函数 也 可 以 接受 声明 时 指定 的 参数 。 在 第 38 行 ， 我 们 指定 匿名 函数 要 接受 两 个 参数 ， 
一 个 类 型 为 Matcher ， 另 一 个 是 指向 一 个 Feed 类 型 值 的 指针 。 这 意味 着 变量 feed 是 一 个 指 
针 变 量 。 指 针 变量 可 以 方便 地 在 函数 之 间 共 享 数据 。 使 用 指针 变量 可 以 让 函数 访问 并 修改 一 个 变 
量 的 状态 ， 而 这 个 变量 可 以 在 其 他 函数 甚至 是 其 他 goroutine 的 作用 域 里 声明 。 

在 第 41 行 , matcher 和 feed 两 个 变量 的 值 被 传人 匿名 函数 。 在 Go 语言 中 ， 所 有 的 变量 
都 以 值 的 方式 传递 。 因 为 指针 变量 的 值 是 所 指向 的 内 存 地 址 , 在 函数 间 传 递 指针 变量 ， 是 在 传递 
这 个 地 址 值 ， 所 以 依旧 被 看 作 以 值 的 方式 在 传递 。 

在 第 39 行 到 第 40 行 ， 可 以 看 到 每 个 goroutine 是 如 何 工 作 的 ， 如 代码 清单 2-23 所 示 。 














代码 清单 2-23 search/search.go: 第 39 行 到 第 40 行 


39 Match (matcher, feed, searchTerm, results) 
40 waitGroup.Done () 


goroutine 做 的 第 一 件 事 是 调用 一 个 叫 Mat ch 的 函数 ， 这 个 函数 可 以 在 match.go 文件 里 找 
到 。Match 函数 的 参数 是 一 个 Matcher 类 型 的 值 、 一 个 指向 Feed 类 型 值 的 指针 、 搜 索 项 以 及 
输出 结果 的 通道 。 我 们 一 会 儿 再 看 这 个 函数 的 内 部 细节 ， 现 在 只 要 知道 ，Match 困 数 会 搜索 数 
据 源 的 数据 ， 并 将 匹配 结果 输出 到 results 通道 。 

一 旦 Match 函数 调用 完毕 ， 就 会 执行 第 40 行 的 代码 ,递减 WaitGroup 的 计数 。 一 旦 每 个 
goroutine 都 执行 调用 Match 函数 和 Done 方法 , 程序 就 知道 每 个 数据 源 都 处 理 完成 。 调用 Done 





方法 这 一 行 还 有 一 个 值得 注意 的 细节 : WaitGroup 的 值 没 有 作为 参数 传人 匿名 函数 ， 但 是 匿名 
函数 依旧 访问 到 了 这 个 值 。 

Go 语言 支持 闭 包 , 这 里 就 应 用 了 闭 包 。 实际 上 , 在 匿名 函数 内 访问 searchTerm 和 results 
变量 , 也 是 通过 闭 包 的 形式 访问 的 。 因 为 有 了 闭 包 ， 函数 可 以 直接 访问 到 那些 没有 作为 参数 传 入 
的 变量 。 匿名 函数 并 没有 拿 到 这 些 变量 的 副本 , 而 是 直接 访问 外 层 函 数 作用 域 中 声明 的 这 些 变量 
本 身 。 因 为 matcher 和 feed 变量 每 次 调用 时 值 不 相同 ， 所 以 并 没有 使 用 闭 包 的 方式 访问 这 两 
个 变量 ， 如 代码 清单 2-24 所 示 。 

















代码 清单 2-24 search/search.go: 第 29 行 到 第 32 行 























29 // 为 每 个 数据 源 启动 一 个 goroutine 来 查找 结果 

30 for , feed := range feeds { 

31 // 获取 一 个 匹配 器 用 于 查找 

二 人 matcher, exists := matchers [feed.Typel 





可 以 看 到 ， 在 第 30 行 到 第 32 行 ， 变量 feed 和 matcher 的 值 会 随 着 循环 的 迭代 而 改变 。 
如 果 我 们 使 用 闭 包 访问 这 些 变量 , 随 着 外 层 函 数 里 变量 值 的 改变 ,内 层 的 匿名 函数 也 会 感知 到 这 
些 改变 。 所 有 的 goroutine 都 会 因为 闭 包 共享 同样 的 变量 。 除 非 我 们 以 函数 参数 的 形式 传 值 给 函 
数 ， 否 则 绝 大 部 分 goroutine 最 终 都 会 使 用 同一 个 matchez 来 处 理 同 一 个 feed 一 一 这 个 值 很 有 
可 能 是 feeds 切片 的 最 后 一 个 值 。 

随 着 每 个 goroutine 搜索 工作 的 运行 , 将 结果 发 送 到 results 通道 , 并 递减 waitGroup 的 
计数 ， 我 们 需要 一 种 方法 来 显示 所 有 的 结果 ， 并 让 main 函数 持续 工作 ， 直 到 完成 所 有 的 操作 ， 
如 代码 清单 2-25 所 示 。 








代码 清单 2-25 search/search.go: 第 44 行 到 第 57 行 


















































44 // 启动 一 个 goroutine 来 监控 是 否 所 有 的 工作 都 做 完了 
45 go func() { 

46 // 等 候 所 有 任务 完成 

47 waitGroup.Wait () 

48 

49 // 用 关闭 通道 的 方式 ， 通 知 Display 函数 

50 // 可 以 退出 程序 了 

51 close (results) 

52 }() 

53 








54 // 启动 函数 ， 显 示 返 回 的 结果 ， 
55 // 并 且 在 最 后 一 个 结果 显示 完 后 返回 
56 Display (results) 














第 45 行 到 第 56 行 的 代码 解释 起 来 比较 麻烦 ， 等 我 们 看 完 search 包 里 的 其 他 代码 后 再 来 解 
释 。 我 们 现在 只 解释 表面 的 语法 , 随后 再 来 解释 底层 的 机 制 。 在 第 45 行 到 第 52 行 , 我 们 以 goroutine 
的 方式 启动 了 男 一 个 匿名 函数 。 这 个 匿名 函数 没有 输入 参数 ， 使 用 闭 包 访问 了 WaitGroup 和 











results 变量 。 这 个 goroutine 里 面 调用 了 waitGroup 的 Wait 方法 。 这 个 方法 会 导致 goroutine 
阻塞 ， 直 到 WaitGroup 内 部 的 计数 到 达 0。 之 后 ，goroutine 调用 了 内 置 的 close 也 数 ， 关 闭 
了 通道 ， 最 终 导致 程序 终止 。 

Run 函数 的 最 后 一 段 代码 是 第 56 行 。 这 行 调用 了 match.go 文件 里 的 Display 函数 。 一旦 
这 个 函数 返回 ， 程 序 就 会 终止 。 而 之 前 的 代码 保证 了 所 有 results 通道 里 的 数据 被 处 理 之 前 ， 
Display 国 数 不 会 返回 。 





2.3.2 feed.go 

现在 已 经 看 过 了 Run 函数 ， 让 我 们 继续 看 看 search.go 文件 的 第 14 行 中 的 Ret rieveFeeds 
函数 调用 背后 的 代码 。 这 个 函数 读 取 data.json 文件 并 返回 数据 源 的 切片 。 这 些 数据 源 会 输出 内 容 ， 
随后 使 用 各 自 的 匹配 器 进行 搜索 。 代 码 清 单 2-26 给 出 的 是 feed.go 文件 的 前 8 行 代 码 。 





代码 清单 2-26 feed.go: 第 01 行 到 第 08 行 


01 Package search 

02 

03-“1mport, ( 

04 "encoding/json" 
05 "osn" 


08 const dataFile = "data/data.json" 

这 个 代码 文件 在 search 文件 夹 里 , 所 以 第 01 行 声 明了 包 的 名 字 为 search。 第 03 行 到 第 
06 行 导 入 了 标准 库 中 的 两 个 包 。json 包 提 供 编 解码 JSON 的 功能 ，os 包 提 供 访问 操作 系统 的 
功能 ， 如 读 文 件 。 

读者 可 能 注意 到 了 ， 导 入 json 包 的 时 候 需要 指定 encoding 路 径 。 不 考虑 这 个 路 径 的 话 ， 
我 们 导入 包 的 名 字 叫 作 json。 不 管 标准 库 的 路 径 是 什么 样 的 ， 并 不 会 改变 包 名 。 我 们 在 访问 json 
包 内 的 函数 时 ， 依 旧 是 指定 json 这 个 名 字 。 

在 第 08 行 , 我 们 声明 了 一 个 叫 作 dataFile 的 常量 ， 使 用 内 容 是 磁盘 上 根据 相对 路 径 指 定 
的 数据 文件 名 的 字符 串 做 初始 化 。 因 为 Go 编译 需 可 以 根据 赋值 运算 符 右 边 的 值 来 推导 类 型 ， 声 
明 常 量 的 时 候 不 需要 指定 类 型 。 此 外 ,这 个 常量 的 名 称 使 用 小 写字 母 开 头 ， 表 示 它 只 能 在 search 
包 内 的 代码 里 直接 访问 ， 而 不 暴露 到 包 外 面 。 

接着 我 们 来 看 看 data. json 数据 文件 的 部 分 内 容 ， 如 代码 清单 2-27 所 示 。 


代码 清单 2-27 data.json 


[ 











{ 
条 让 七 才 型 : i 
"iink™" : "http://www.npr.org/rss/rss.php?id=1001", 
"type" : HE 


SELLES ® Werin™., 


"link" : "http://rss.cnn.com/rss/cnn world.rss", 
"type" : 时 

jj 

{ 
"site"™" : "foxnews", 
"link" : "http://feeds.foxnews.com/foxnews/world?format=xml", 
"type" : "rss" 

}, 

下 
"site" : "nbcnews", 
"link" : "http://feeds.nbcnews.com/feeds/topstories", 
"type" : "rss" 


} 
] 


为 了 保证 数据 的 有 效 性 ， 代 码 清单 2-27 只 选用 了 4 个 数据 源 ， 实 际 数据 文件 包含 的 数据 要 
比 这 4 个 多 。 数 据 文件 包括 一 个 JSON 文档 数组 。 数 组 的 每 一 项 都 是 一 个 JSON 文档 ， 包 含 获 取 
数据 的 网 站 名 、 数 据 的 链接 以 及 我 们 期 望 获得 的 数据 类 型 。 

这 些 数据 文档 需要 解码 到 一 个 结构 组 成 的 切片 里 , 以 便 我 们 能 在 程序 里 使 用 这 些 数据 。 来 看 
看 用 于 解码 数据 文档 的 结构 类 型 ， 如 代码 清单 2-28 所 示 。 


代码 清单 2-28 feed.go: 第 10 行 到 第 15 行 
10 // Feed 包含 我 们 需要 处 理 的 数据 源 的 信息 
11 type Feed struct { 





2 Name string “json:"site". 
13 URI String “json:"link". 
14 Type string “json:"type". 
19. 让 


在 第 11 行 到 第 15 行 , 我 们 声明 了 一 个 名 叫 Feed 的 结构 类 型 。 这 个 类 型 会 对 外 暴露 。 这 个 
类 型 里 面 声明 了 3 个 字段 ， 每 个 字段 的 类 型 都 是 字符 串 ， 对 应 于 数据 文件 中 各 个 文档 的 不 同 字段 。 
每 个 字段 的 声明 最 后 ”引号 里 的 部 分 被 称 作 标记 (tag )。 这 个 标记 里 描述 了 JSON 解码 的 元 数据 ， 
用 于 创建 Feed 类 型 值 的 切片 。 每 个 标记 将 结构 类 型 里 字段 对 应 到 JSON 文档 里 指定 名 字 的 字段 。 
现在 可 以 看 看 search.go 代码 文件 的 第 14 行 中 调用 的 Ret rieveFeeds 畏 数 了 。 这 个 函数 读 
取 数 据 文件 , 并 将 每 个 JSON 文档 解码 , 存 人 一 个 Feed 类 型 值 的 切片 里 , 如 代码 清单 2-29 所 示 。 


代码 清单 2-29 feed.go: 第 17 行 到 第 36 行 


17 // RetrieveFeeds 读 取 并 反 序 列 化 源 数 据 文件 








18 func RetrieveFeeds() ([]*Feed, error) { 
19 // 打开 文件 

20 file, err := os.Open (dataFile) 

21 if err != nil { 

22 return nil, err 


23 } 











25 // 当 函 数 返回 时 

26 // 关闭 文件 

27 defer file.Close() 
28 


29 // 将 文件 解码 到 一 个 切片 里 
30 // 这 个 切片 的 每 一 项 是 一 个 指向 一 个 Feed 类 型 值 的 指针 



































也 下 var feedqs []*Feed 

32 err = json.NewDecoder (file) .Decode (&feeds) 
33 

34 // 这 个 函数 不 需要 检查 错误 ， 调 用 者 会 做 这 件 事 

35 return feeds, err 

36 } 


让 我 们 从 第 18 行 的 函数 声明 开始 。 这 个 函数 没有 参数 ， 会 返回 两 个 值 。 第 一 个 返回 值 是 一 
个 切片 ， 其 中 每 一 项 指向 一 个 Feed 类 型 的 值 。 第 二 个 返回 值 是 一 个 error 类 型 的 值 ， 用 来 表 
示 函 数 是 否 调用 成 功 。 在 这 个 代码 示例 里 ， 会 经 常 看 到 返回 error 类 型 值 来 表示 函数 是 否 调 用 
成 功 。 这 种 用 法 在 标准 库 里 也 很 常见 。 

现在 让 我 们 看 看 第 20 行 到 第 23 行 。 在 这 几 行 里 ， 我 们 使 用 os 包 打开 了 数据 文件 。 我 们 使 
用 相对 路 径 调 用 open 方法 ， 并 得 到 两 个 返回 值 。 第 一 个 返回 值 是 一 个 指针 ， 指 向 File 类 型 的 
值 , 第 二 个 返回 值 是 error 类 型 的 值 ， 检查 open 调用 是 否 成 功 。 紧 接着 第 21 行 就 检查 了 返回 
的 error 类 型 错误 值 ， 如 果 打 开 文件 真 的 有 问题 ， 就 把 这 个 错误 值 返回 给 调用 者 。 

如 果 成 功 打 开 了 文件 ,会 进入 到 第 27 行 。 这 里 使 用 了 关键 字 defer ， 如 代码 清单 2-30 所 示 。 



































代码 清单 2-30 feed.go: 第 25 行 到 第 27 行 














25 // 当 函 数 返回 时 
26 // 关闭 文件 
27 defer file.Close() 








关键 字 defer 会 安排 随后 的 函数 调用 在 函数 返回 时 才 执 行 。 在 使 用 完 文 件 后 ， 需 要 主动 关 
闭 文件 。 使 用 关键 字 defer 来 安排 调用 Close 方法 ,可 以 保证 这 个 函数 一 定 会 被 调用 。 哪 怕 郴 
数 意 外 月 演 终 止 , 也 能 保证 关键 字 aefer 安排 调用 的 函数 会 被 执行 。 关 键 字 defer 可 以 缩短 打 
开 文 件 和 关闭 文件 之 间 间 隔 的 代码 行 数 ， 有 助 提 高 代码 可 读 性 ， 减 少 错误 。 

现在 可 以 看 看 这 个 函数 的 最 后 几 行 ， 如 代码 清单 2-31 所 示 。 先 来 看 一 下 第 31 行 到 第 35 行 
的 代码 。 


代码 清单 2-31 feed.go: 第 29 行 到 第 36 行 


29 // 将 文件 解码 到 一 个 切片 里 
30 // 这 个 切片 的 每 一 项 是 一 个 指向 一 个 Feed 类 型 值 的 指针 



































3 var feeds []*Feed 

32 err = json.NewDecoder (file) .Decode (&feeds) 
33 

34 // 这 个 函数 不 需要 检查 错误 ， 调 用 者 会 做 这 件 事 

35 return feeds, err 


在 第 31 行 我 们 声明 了 一 个 名 字 叫 feeds ， 值 为 nil 的 切片 ， 这 个 切片 包含 一 组 指向 Feed 
类 型 值 的 指针 。 之 后 在 第 32 行 我 们 调用 json 包 的 NewDecogder 函数 ,然后 在 其 返回 值 上 调用 
Decode 方法 。 我 们 使 用 之 前 调用 open 返回 的 文件 句柄 调用 NewDecoder 本 数 ， 并 得 到 一 个 
指向 Decoder 类 型 的 值 的 指针 。 之 后 再 调用 这 个 指针 的 Decode 方法 , 传人 切片 的 地 址 。 之 后 
Decode 方法 会 解码 数据 文件 ， 并 将 解码 后 的 值 以 Feed 类 型 值 的 形式 存 人 切片 里 。 

根据 Decoge 方法 的 声明 ， 该 方法 可 以 接受 任何 类 型 的 值 ， 如 代码 清单 2-32 所 示 。 


func (dec *Decoder) Decode (V interface{}) error 

Decode 方法 接受 一 个 类 型 为 interfacet ) 的 值 作为 参数 。 这 个 类 型 在 Go 语言 里 很 特殊 ， 
一 般 会 配合 reflect 包 里 提供 的 反射 功能 一 起 使 用 。 

最 后 ， 第 35 行 给 函数 的 调用 者 返回 了 切片 和 错误 值 。 在 这 个 例子 里 ， 不 需要 对 Decode 调 
用 之 后 的 错误 做 检查 。 函 数 执行 结束 ， 这 个 函数 的 调用 者 可 以 检查 这 个 错误 值 ， 并 决定 后 续 如 何 
处 理 。 

现在 让 我 们 看 看 搜索 的 代码 是 如 何 支持 不 同类 型 的 数据 源 的 。 让 我 们 去 看 看 匹配 器 的 代码 ， 














2.3.3 match.go/default.go 


match.go 代码 文件 包含 创建 不 同类 型 匹配 器 的 代码 ， 这 些 匹配 器 用 于 在 Run 函数 里 对 数据 
进行 搜索 。 让 我 们 回头 看 看 Run 函数 里 使 用 不 同 匹配 需 执 行 搜索 的 代码 , 如 代码 清单 2-33 所 示 。 





代码 清单 2-33 search/search.go: 第 29 行 到 第 42 行 
29 // 为 每 个 数据 源 启动 一 个 goroutine 来 查找 结果 






































30 for , feed := range feeds { 

31 // 获取 一 个 匹配 器 用 于 查找 

32 matcher, exists := matchers [feed.Typel] 
33 if lexists { 

34 matcher = matchers["default"] 

35 } 

36 

37 // 启动 一 个 goroutine 执行 查找 

28 go func (matcher Matcher, feed *Feed) { 
39 Match (matcher, feed, searchTerm, results) 
40 waitGroup.Done () 

41 } (matcher, feed) 

42 } 














代码 的 第 32 行 ， 根 据 数 据 源 类 型 查找 一 个 匹配 需 值 。 这 个 匹配 器 值 随后 会 用 于 在 特定 的 数 
据 源 里 处 理 搜索 。 之 后 在 第 38 行 到 第 41 行 启 动 了 一 个 goroutine, 让 匹配 妖 对 数据 源 的 数据 进行 
搜索 。 让 这 段 代码 起 作用 的 关键 是 这 个 架构 使 用 一 个 接口 类 型 来 匹配 并 执行 具有 特定 实现 的 匹配 
器 。 这 样 ， 就 能 使 用 这 段 代 码 ， 以 一 致 且 通用 的 方法 , 来 处 理 不 同类 型 的 匹配 器 值 。 让 我 们 看 一 























下 match.go 里 的 代码 ， 看 看 如 何 才能 实现 这 一 功能 。 
代码 清单 2-34 给 出 的 是 match.go 的 前 17 行 代码 。 





代码 清单 2-34 search/match.go: 第 01 行 到 第 17 行 


01 Package search 


02 

03 import. “( 
04 "log" 
05:.) 

06 


07 // Result 保存 搜索 的 结果 
08 type Result struct { 


09 Field string 
10 Content string 
ee 





2 
13 // Matcher 定义 了 要 实现 的 
14 // 新 搜索 类 型 的 行为 
5 type Matcher interface { 
6 Search (feed *Feed, searchTerm string) ([]*Result, error) 
7 





I 
让 我 们 看 一 下 第 15 行 到 第 17 行 ， 这 里 声明 了 一 个 名 为 Mat cher 的 接口 类 型 。 之 前 ,我 们 
只 见 过 声明 结构 类 型 ， 而 现在 看 到 如 何 声明 一 个 interface (接口 ) 类 型 。 我 们 会 在 第 5 章 介 
绍 接口 的 更 多 细节 ,现在 只 需要 知道 ，interface 关键 字 声 明了 一 个 接口 ， 这 个 接口 声明 了 结构 
类 型 或 者 具名 类 型 需要 实现 的 行为 。 一 个 接口 的 行为 最 终 由 在 这 个 接口 类 型 中 声明 的 方法 决定 。 

对 于 Matcher 这 个 接口 来 说 ， 只 声明 了 一 个 Search 方法 ， 这 个 方法 输入 一 个 指向 Feed 
类 型 值 的 指针 和 一 个 string 类 型 的 搜索 项 。 这 个 方法 返回 两 个 值 : 一 个 指向 Result 类 型 值 
的 指针 的 切片 ， 另 一 个 是 错误 值 。Result 类 型 的 声明 在 第 08 行 到 第 11 行 。 

命名 接口 的 时 候 ， 也 需要 遵守 Go 语言 的 命名 惯例 。 如 果 接 口 类 型 只 包含 一 个 方法 ,那么 这 
个 类 型 的 名 字 以 er 结尾 。 我 们 的 例子 里 就 是 这 么 做 的 , 所 以 这 个 接口 的 名 字 叫 作 Matcher。 如 
果 接 口 类 型 内 部 声明 了 多 个 方法 ， 其 名 字 需 要 与 其 行为 关联 。 

如 果 要 让 一 个 用 户 定义 的 类 型 实现 一 个 接口 ， 这 个 用 户 定义 的 类 型 要 实现 接口 类 型 里 声明 的 
所 有 方法 。 让 我 们 切换 到 default.go 代码 文件 ， 看 看 默认 匹配 器 是 如 何 实现 Matcher 接口 的 ， 
如 代码 清单 2-35 所 示 。 























代码 清单 2-35 search/defaultgo: 第 01 行 到 第 15 行 


01 Package search 

02 

03 // defaultMatcher 实现 了 默认 匹配 器 
04 type defaultMatcher struct{} 

05 

06 // init 函数 将 默认 匹配 器 注册 到 程序 里 
07 func init() { 














08 Var matcher defaultMatcher 





09 Register("default", matcher) 

10 } 

3 

12 // Search 实现 了 默认 匹配 器 的 行为 

13 func (m defaultMatcher) Search (feedq *Feed, searchTerm string) ([]*Result, error) { 
14 return nil, nil 

15: ,3 


在 第 04 行 ， 我 们 使 用 一 个 空 结构 声明 了 一 个 名 叫 defaultMatcher 的 结构 类 型 。 空 结构 
在 创建 实例 时 , 不 会 分 配 任 何 内 存 。 这 种 结构 很 适合 创建 没有 任何 状态 的 类 型 。 对 于 默认 匹配 器 
来 说 ,不 需要 维护 任何 状态 ， 所 以 我 们 只 要 实现 对 应 的 接口 就 行 。 

在 第 13 行 到 第 15 行 ， 可 以 看 到 defaultMatcher 类 型 实现 Matcher 接口 的 代码 。 实 现 
接口 的 方法 Search 只 返回 两 个 nil 值 。 其 他 的 实现 ， 如 RSS 匹配 器 的 实现 ， 会 在 这 个 方法 里 
使 用 特定 的 业务 逻辑 规则 来 处 理 搜索 。 

Search 方法 的 声明 也 声明 了 defaultMat cher 类 型 的 值 的 接收 者 ,如 代码 清单 2-36 所 示 。 








代码 清单 2-36 search/defaultgo: 第 13 行 
13 func (m defaultMatcher) Search 
如 果 声 明 函 数 的 时 候 带 有 接收 者 , 则 意味 着 声明 了 一 个 方法 。 这 个 方法 会 和 指定 的 接收 者 的 
类 型 绑 在 一 起 。 在 我 们 的 例子 里 ，Search 方法 与 defaultMatcher 类 型 的 值 绑 在 一 起 。 这 意 





味 着 我 们 可 以 使 用 aefaultMatchet 类 型 的 值 或 者 指向 这 个 类 型 值 的 指针 来 调用 Search 方 
法 。 无 论 我 们 是 使 用 接收 者 类 型 的 值 来 调用 这 个 方 ， 还 是 使 用 接收 者 类 型 值 的 指针 来 调用 这 个 
方法 , 编译 右 都 会 正确 地 引用 或 者 解 引用 对 应 的 值 , 作为 接收 者 传递 给 Search 方法 ,如 代码 清 
单 2-37 所 示 。 





代码 清单 2-37 调用 方法 的 例子 
// 方法 声明 为 使 用 defaultMatcher 类 型 的 值 作为 接收 者 























func (m defaultMatcher) Search(feed *Feed, searchTerm string) 


// 声明 一 个 指向 defaultMatcher 类 型 值 的 指针 
dm := new (defaultMatch) 



































// 编译 器 会 解 开 dm 指针 的 引用 ， 使 用 对 应 的 值 调 用 方法 


dm.Search (feed, "test") 























// 方法 声明 为 使 用 指向 defaultMatcher 类 型 值 的 指针 作为 接收 者 


func (m *defaultMatcher) Search (feed *Feed, searchTerm string) 








// 声明 一 个 defaultMatcher 类 型 的 值 
var dm defaultMatch 














// 编译 器 会 自动 生成 指针 引用 dm 值 ， 使 用 指针 调用 方法 


dm.Search (feed, "test") 



































因为 大 部 分 方法 在 被 调用 后 都 需要 维护 接收 者 的 值 的 状态 ,所 以 , 一 个 最 佳 实践 是 , 将 方法 
的 接收 者 声明 为 指针 。 对 于 defaultMatcher 类 型 来 说 ， 使 用 值 作为 接收 者 是 因为 创建 一 个 
defaultMatcher 类 型 的 值 不 需要 分 配 内 存 。 由 于 defaultMatcher 不 需要 维护 状态 ， 所 以 
不 需要 指针 形式 的 接收 者 。 

与 直接 通过 值 或 者 指针 调用 方法 不 同 ， 如 果 通 过 接口 类 型 的 值 调用 方法 ， 规 则 有 很 大 不 同 ， 
如 代码 清单 2-38 所 示 。 使 用 指针 作为 接收 者 声明 的 方法 ， 只 能 在 接口 类 型 的 值 是 一 个 指针 的 时 
候 被 调用 。 使 用 值 作为 接收 者 声明 的 方法 ， 在 接口 类 型 的 值 为 值 或 者 指针 时 ， 都 可 以 被 调用 。 


代码 清单 2-38 接口 方法 调用 所 受 限 制 的 例子 
// 方法 声明 为 使 用 指向 defaultMatchet 类 型 值 的 指针 作为 接收 者 


























func (m *defaultMatcher) Search (feedq *Feed, searchTerm string) 

















// 通过 interface 类 型 的 值 来 调用 方法 

var dm defaultMatcher 

var matcher Matcher = dm // 将 值 赋值 给 接口 类 型 
matcher.Search (feedq，"test") // 使 用 值 来 调用 接口 方法 












































> go build 
cannot use dm (type defaultMatcher) as type Matcher in assignment 














// 方法 声明 为 使 用 defaultMatcher 类 型 的 值 作为 接收 者 


func (m defaultMatcher) Search (feed *Feed, searchTerm string) 
































// 通过 interface 类 型 的 值 来 调用 方法 

var dm defaultMatcher 

var matcher Matcher = &dm // 将 指针 赋值 给 接口 类 型 
matcher.Search (feedq，"test") // 使 用 指针 来 调用 接口 方法 









































> go build 
Build Successful 


除了 Search 方法 ，defaultMatcher 类 型 不 需要 为 实现 接口 做 更 多 的 事情 了 。 从 这 段 代 
码 之 后 ,不论 是 defaultMatcher 类 型 的 值 还 是 指针 ， 都 满足 Matcher 接口 ， 都 可 以 作为 
Mat cher 类 型 的 值 使 用 。 这 是 代码 可 以 工作 的 关键 defaultMatcher 类 型 的 值 和 指针 现在 还 
可 以 作为 Matcher 的 值 ， 赋 值 或 者 传递 给 接受 Mat chez 类 型 值 的 函数 。 

让 我 们 看 看 match.go 代码 文件 里 实现 Match 函数 的 代码 , 如 代码 清单 2-39 所 示 。 这 个 函数 
在 search.go 代码 文件 的 第 39 行 中 由 Run 函数 调用 。 











代码 清单 2-39 search/match.go: 第 19 行 到 第 33 行 








19 // Match 函数 ， 为 每 个 数据 源 单独 启动 goroutine 来 执行 这 个 函数 

20 // 并 发 地 执行 搜索 

21 func Match (matcher Matcher, feed *Feed, searchTerm string, results chan<- *Result) { 
22 // 对 特定 的 匹配 器 执行 搜索 

2 和 searchResults, err := matcher.Search (feedq， searchTerm) 

24 if err != nil { 











2 log.Println (err) 

















26 return 

2 } 

28 

29 // 将 结果 写 入 通道 

30 for , result := range searchResults { 
34 results <- result 

32 } 

3 


这 个 函数 使 用 实现 了 Matcher 接口 的 值 或 者 指针 ， 进 行 真 正 的 搜索 。 这 个 函数 接受 
Matcher 类 型 的 值 作为 第 一 个 参数 。 只 有 实现 了 Mat cher 接口 的 值 或 者 指针 能 被 接受 。 因 为 
defaultMatcher 类 型 使 用 值 作为 接收 者 ， 实 现 了 这 个 接口 ， 所 以 defaultMatcher 类 型 的 
值 或 者 指针 可 以 传人 这 个 函数 。 

在 第 23 行 , 调用 了 传人 函数 的 Mat chez 类 型 值 的 Search 方法 。 这 里 执行 了 Matcher 变 
量 中 特定 的 Search 方法 。Search 方法 返回 后 ， 在 第 24 行 检测 返回 的 错误 值 是 否 真 的 是 一 个 
错误 。 如 果 是 一 个 错误 ， 函 数 通过 1og 输出 错误 信息 并 返回 。 如 果 搜 索 并 没有 返回 错误 ， 而 是 
返回 了 搜索 结果 ， 则 把 结果 写 和 通道， 以 便 正在 监听 通道 的 main 函数 就 能 收 到 这 些 结果 。 

match.go 中 的 最 后 一 部 分 代码 就 是 main 函数 在 第 56 行 调用 的 Display 函数 ,如 代码 清 
单 2-40 所 示 。 这 个 函数 会 阻止 程序 终止 ， 直 到 接收 并 输出 了 搜索 goroutine 返回 的 所 有 结果 。 





代码 清单 2-40 search/match.go: 第 35 行 到 第 43 行 





35 // Display 从 每 个 单独 的 goroutine 接收 到 结果 后 
36 // 在 终端 窗口 输出 
37 func Display(results chan *Result) { 
38 // 通道 会 一 直 被 阻塞 ， 直 到 有 结果 写 入 
































39 // 一 旦 通道 被 关闭 ，for 循环 就 会 终止 

40 for result := range results { 

41 fmt.Printf("%s:\nss\n\n", result.Field, result.Content) 
42 } 

43 } 


当 通 道 被 关闭 时 ， 通 道 和 关键 字 range 的 行为 ， 使 这 个 函数 在 处 理 完 所 有 结果 后 才 会 返回 。 
让 我 们 再 来 简单 看 一 下 Run 函数 的 代码 ， 特 别 是 关闭 results 通道 并 调用 Display 函数 那 段 ， 
如 代码 清单 2-41 所 示 。 





代码 清单 2-41 search/search.go: 第 44 行 到 第 57 行 















































44 // 启动 一 个 goroutine 来 监控 是 否 所 有 的 工作 都 做 完了 
45 go func() { 

46 // 等 候 所 有 任务 完成 

47 waitGroup.Wait () 

48 

49 // 用 关闭 通道 的 方式 ， 通 知 Display 函数 

50 // 可 以 退出 程序 了 

5 close (results) 


52 }() 








54 // 启动 函数 ， 显 示 返 回 的 结果 ， 
55 // 并 且 在 最 后 一 个 结果 显示 完 后 返回 
56 Display (results) 














第 45 行 到 第 52 行 定义 的 goroutine 会 等 待 waitGroup， 直 到 搜索 goroutine 调用 了 Done 
方法 ,一旦 最 后 一 个 搜索 goroutine 调用 了 Done, Wait 方法 会 返回 , 之 后 第 51 行 的 代码 会 关闭 
results 通道 。 一 旦 通道 关闭 ，goroutine 就 会 终止 ， 不 再 工作 。 

在 match.go 代码 文件 的 第 30 行 到 第 32 行 , 搜索 结果 会 被 写 人 通道 , 如 代码 清单 2-42 所 示 。 


代码 清单 2-42 search/match.go: 第 29 行 到 第 32 行 




















29 // 将 结果 写 入 通道 

30 for , result := range searchResults { 
31 results <- result 

32 } 


如 果 回 头 看 一 看 match.go 代码 文件 的 第 40 行 到 第 42 行 的 for range 循环 ， 如 代码 清单 2-43 
所 示 ， 我 们 就 能 把 写 人 结果 、 关 闭 通道 和 处 理 结果 这 些 流 程 串 在 一 起 。 


代码 清单 2-43 search/match.go: 第 38 行 到 第 42 行 

















38 // 通道 会 一 直 被 阻塞 ， 直 到 有 结果 写 入 














39 // 一 旦 通道 被 关闭 ，for 循环 就 会 终止 

40 for result := range results { 

41 fmt.Printf("%s:\nss\n\n", result.Field, result.Content) 
42 } 


match.go 代码 文件 的 第 40 行 的 for range 循环 会 一 直 阻 塞 ， 直 到 有 结果 写 人 通道 。 在 某 
个 搜索 goroutine 向 通道 写 人 结果 后 ( 如 在 match.go 代码 文件 的 第 31 行 所 见 )，for range 循 
环 被 唤醒 ， 读 出 这 些 结果 。 之 后 ， 结 果 会 立刻 写 到 日 志 中 。 看 上 去 这 个 for range 循环 会 无 限 
循环 下 去 ， 但 其 实 不 然 。 一 旦 search.go 代码 文件 第 51 行 关闭 了 通道 ，for range 循环 就 会 终 
止 ，Display 六 数 也 会 返回 。 

在 我 们 去 看 RSS 匹配 融 的 实现 之 前 ， 再 看 一 下 程序 开始 执行 时 ， 如 何 初始 化 不 同 的 匹配 器 。 
为 此 ， 我 们 需要 先 回头 看 看 default.go 代码 文件 的 第 07 行 到 第 10 行 ， 如 代码 清单 2-44 所 示 。 





代码 清单 2-44 ”search/default.go: 第 06 行 到 第 10 行 





06 // init 函数 将 默认 匹配 器 注册 到 程序 里 








07 func init() { 

08 Var matcher defaultMatcher 
09 Register("default", matcher) 
10 } 


在 代码 文件 default.go 里 有 一 个 特殊 的 函数 ， 名 叫 init。 在 main.go 代码 文件 里 也 能 看 到 同 
名 的 函数 。 我 们 之 前 说 过 ， 程 序 里 所 有 的 init 方法 都 会 在 main 函数 启动 前 被 调用 。 让 我 们 再 


看 看 main.go 代码 文件 导入 了 哪些 代码 ， 如 代码 清单 2-45 所 示 。 


代码 清单 2-45 ”main.go: 第 07 行 到 第 08 行 





07 _ "github.com/goinaction/code/chapter2/sample/matchers" 
08 "github.com/goinaction/code/chapter2/sample/search" 


第 8 行 导 入 search 包 , 这 让 编译 器 可 以 找到 default.go 代码 文件 里 的 init 函数 。 一 旦 
编译 器 发 现 init 函数 ， 它 就 会 给 这 个 函数 优先 执行 的 权限 ， 保 证 其 在 main 函数 之 前 被 调用 。 

代码 文件 default.go 里 的 init 函数 执行 一 个 特殊 的 任务 。 这 个 函数 会 创建 一 个 
defaultMatcher 类 型 的 值 ， 并 将 这 个 值 传递 给 search.go 代码 文件 里 的 Register 函数 ， 如 
代码 清单 2-46 所 示 。 


代码 清单 2-46 search/search.go: 第 59 行 到 第 67 行 
59 // Register 调用 时 ， 会 注册 一 个 匹配 器 ， 提 供给 后 面 的 程序 使 用 





























60 func Register (feedType string, matcher Matcher) { 


61 if , exists := matchers[feedTypel]; exists { 

62 log.Fatalln (feedType, "Matcher already registered") 
63 } 

64 

65 log.Println("Register", feedType, "matcher") 

66 matchers[feedType] = matcher 

67 } 


这 个 函数 的 职责 是 ,将 一 个 Matcher 值 加 入 到 保存 注册 匹配 回 的 映射 中 。 所 有 这 种 注 
册 都 应 该 在 main 函数 被 调用 前 完成 。 使 用 init 函数 可 以 非常 完美 地 完成 这 种 初始 化 时 注 
册 的 任务 。 


eX 六 闪 匹配 器 


最 后 要 看 的 一 部 分 代码 是 RSS 匹配 器 的 实现 代码 。 我 们 之 前 看 到 的 代码 搭建 了 一 个 框架 ， 
以 便 能 够 实现 不 同 的 匹配 器 来 搜索 内 容 。RSS 匹配 顺 的 结构 与 默认 匹配 器 的 结构 很 类 似 。 每 个 匹 
配 需 为 了 匹配 接口 ，Seazrcn 方法 的 实现 都 不 同 ， 因 此 匹配 融 之 间 无 法 互相 替换 。 

代码 清单 2-47 中 的 RSS 文档 是 一 个 例子 。 当 我 们 访问 数据 源 列表 里 RSS 数据 源 的 链接 时 ， 
期 望 获 得 的 数据 就 和 这 个 例子 类 似 。 















































代码 清单 2-47 ”期 望 的 RSsS 数据 源 文档 


<rss xmlns:npr="http://www.npr.org/rss/" xmlns:nprml="http://api" 
<channel> 
<title>News</title> 
<link>...</link> 
<description>...</description> 


<language>en</language> 


<copyright>Copyright 2014 NPR - For Personal Use 
<image>...</image> 
<item> 
<title> 
Putin Says He'll Respect Ukraine Vote But U.S. 
</title> 
<description> 
The White House and State Department have called on the 
</description> 


如 果 用 浏览 器 打开 代码 清单 2-47 中 的 任意 一 个 链接 ， 就 能 看 到 期 望 的 RSS 文档 的 完整 内 容 。RSS 
匹配 器 的 实现 会 下 载 这 些 RSS 文档 ,使 用 搜索 项 来 搜索 标题 和 描述 域 ， 并 将 结果 发 送 给 results 
通道 。 让 我 们 先 看 看 rss.go 代码 文件 的 前 12 行 代码 ， 如 代码 清单 2-48 所 示 。 





代码 清单 2-48 matchers/rss.go: 第 01 行 到 第 12 行 


01 package matchers 


02 

03 import ( 

04 "encoding/xml" 
05 "errors" 

06 fim 

07 "log" 

08 "net/http" 

09 "regexp" 

10 

11 "github.com/goinaction/code/chapter2/sample/search" 
于 入 


和 其 他 代码 文件 一 样 , 第 1 行 定义 了 包 名 。 这 个 代码 文件 处 于 名 叫 mat chers 的 文件 夹 中 ， 
所 以 包 名 也 叫 matchers。 之 后 , 我 们 从 标准 库 中 导入 了 6 个 库 , 还 导入 了 search 包 。 再 一 次 ， 
我 们 看 到 有 些 标 准 库 的 包 是 从 标准 库 所 在 的 子 文件 夹 导 人 的 , 如 xml 和 http。 就 像 json 包 一 
样 ， 路 径 里 最 后 一 个 文件 夹 的 名 字 代 表 包 的 名 字 。 

为 了 让 程序 可 以 使 用 文档 里 的 数据 ， 解 码 RSS 文档 的 时 候 需 要 用 到 4 个 结构 类 型 ， 如 代码 
清单 2-49 所 示 。 








代码 清单 2-49 matchers/rss.go: 第 14 行 到 第 58 行 


14 type ( 
15 // item 根据 item 字段 的 标签 ， 将 定义 的 字段 
16 // 与 rss 文档 的 字段 关联 起 来 


三 肖 item struct { 

18 XMLName xml.Name ‘xml:"item". 

19 PubDate string ‘xml:"pubDate". 

20 Title string “xml:"title". 

21 Description string “xml:"description". 
22 Link string “xmL: "Link™. 

23 GUID string ~xml: "guid”™ 

24 GeoRssPoint string xml:"georss:point". 


26 
2 了 // image 根据 image 字段 的 标签 ， 将 定义 的 字段 
28 // 与 rss 文档 的 字段 关联 起 来 

















29 image struct { 

30 XMLName xml.Name ‘xml:"image". 

号 二 URL string XL 

32 Title string xml:"title". 

33 Link string ~ xml:"link". 

34 } 

35 

36 // channel 根据 channel 字段 的 标签 ， 将 定义 的 字段 

37 // 与 rss 文档 的 字段 关联 起 来 

38 channel struct { 

39 XMLName xml.Name “Xml:"channel" 

40 Title string Xml Et le 

41 Description string xml:"description". 
42 Link string ~ xml:"link". 

43 PubDate string “xml:"pubDate". 

44 LastBuildDate StLLNG. xml:"lastBuildDate". 
45 TTL string > MES tt 

46 Language string xml:"language". 

47 ManagingEditor string “xml:"managingEditor". 
48 WebMaster string ‘xml:"webMaster". 
49 [Image image xml:"image". 

50 [tem [] item xml:"item". 

Sl } 

52 

53 // rssDocument 定义 了 与 rss 文档 关联 的 字段 

54 rssDocument struct { 

re XMLName xml.Name ‘xml:"rss". 

56 Channel channel ‘xml:"channel". 

57 } 

58 ) 


如 果 把 这 些 结构 与 任意 一 个 数据 源 的 RSS 文档 对 比 ， 就 能 发 现 它们 的 对 应 关系 。 解 码 XML 
的 方法 与 我 们 在 feed.go 代码 文件 里 解码 JSON 文档 一 样 。 接 下 来 我 们 可 以 看 看 rssMat cher 类 
型 的 声明 ， 如 代码 清单 2-50 所 示 。 





代码 清单 2-50 matchers/rss.go: 第 60 行 到 第 61 行 











60 // rssMatcher 实现 了 Matcher 接 
61 type rssMatcher structt{} 


再 说 明 一 次 ， 这 个 声明 与 defaultMatcher 类 型 的 声明 很 像 。 因 为 不 需要 维护 任何 状态 ， 
所 以 我 们 使 用 了 一 个 空 结构 来 实现 Matcher 接口 。 接 下 来 看 看 匹配 器 init 函数 的 实现 ， 如 代 
码 清单 2-51 所 示 。 








代码 清单 2.51 matchers/rss.go: 第 63 行 到 第 67 行 


63 // init 将 匹配 器 注册 到 程序 里 
64 func init () { 
65 Var matcher rssMatcher 





66 search.Register("rss", matcher) 





就 像 在 默认 匹配 带 里 看 到 的 一 样 ,init 消 数 将 rssMat cher 类 型 的 值 注册 到 程序 里 , 以 备 
后 用 。 让 我 们 再 看 一 次 main.go 代码 文件 里 的 导入 部 分 ， 如 代码 清单 2-52 所 示 。 


代码 清单 2-52 main.go: 第 07 行 到 第 08 行 





07 _ "github.com/goinaction/code/chapter2/sample/matchers" 
08 "github.com/goinaction/code/chapter2/sample/search" 


main.go 代码 文件 里 的 代码 并 没有 直接 使 用 任何 matchers 包 里 的 标识 符 。 不 过 ,我 们 依旧 
需要 编译 絮 安 排 调 用 rss.go 代码 文件 里 的 init 隐 数 。 在 第 07 行 ， 我 们 使 用 下 划 线 标识 符 作 为 
别名 导入 matchers 包 ， 完 成 了 这 个 调用 。 这 种 方法 可 以 让 编译 器 在 导入 未 被 引用 的 包 时 不 报 
错 ,， 而且 依旧 会 定位 到 包 内 的 init 函数 。 我 们 已 经 看 过 了 所 有 的 导入 、 类 型 和 初始 化 函数 ， 现 
在 来 看 看 最 后 两 个 用 于 实现 Mat cher 接口 的 方法 ， 如 代码 清单 2-53 所 示 。 


代码 清单 2-53 matchers/rss.go: 第 114 行 到 第 140 行 



























































114 // retrieve 发 送 HTTP Get 请 求 获取 rss 数据 源 并 解码 

115 func (m rssMatcher) retrieve (feed *search.Feed) (*rssDocument, error) { 
116 if feed.URI == "™ { 

117 return nil, errors.New("No rss feed URI provided") 
118 } 

9 

120 // 从 网 络 获得 rss 数据 源 文档 

2 resp, err := http.Get (feed.URI) 

122 if err != nil { 

123 return nil, err 

124 } 

125 

126 // 一 旦 从 函数 返回 ， 关 闭 返 回 的 响应 链接 

127 defer resp.Body.Close() 

128 

129 // 检查 状态 码 是 不 是 200， 这 样 就 能 知道 

130 // 是 不 是 收 到 了 正确 的 响应 

3 直 if resp.StatusCode != 200 { 

B32 return nil, fmt.Errorf ("HTTP Response Error $d\n", resp.StatusCode) 
133 } 

134 

135 // 将 rss 数据 源 文档 解码 到 我 们 定义 的 结构 类 型 里 

136 // 不 需要 检查 错误 ， 调 用 者 会 做 这 件 事 

37 var document rssDocument 

1.38 err = xml .NewDecoder (resp.Body) .Decode (&document) 

139 return &document, err 

40 } 


方法 retrieve 并 没有 对 外 暴露 ,其 执行 的 逻辑 是 从 RSS 数据 源 的 链接 拉 取 RSS 文档 。 在 
第 121 行 ， 可 以 看 到 调用 了 http 包 的 Get 方法 。 我 们 会 在 第 8 前 进一步 介绍 这 个 包 ， 现 在 只 
需要 知道 , 使 用 http 包 ，Go 语言 可 以 很 容易 地 进行 网 络 请 求 。 当 Get 方法 返回 后 ， 我 们 可 以 


得 到 一 个 指向 Response 类 型 值 的 指针 。 之 后 会 监测 网 络 请 求 是 否 出 错 ， 并 在 第 127 行 安排 函 
数 返 回 时 调用 Close 方法 。 

在 第 131 行 , 我 们 检测 了 Response 值 的 StatusCode 字段 ， 确 保 收 到 的 响应 是 200。 任 
何不 是 200 的 请 求 都 需要 作为 错误 处 理 。 如 果 响 应 值 不 是 200 , 我 们 使 用 fmt 包 里 的 Errorf 函数 
返回 一 个 自 定 义 的 错误 。 最 后 3 行 代码 很 像 之 前 解码 JSON 数据 文件 的 代码 。 只 是 这 次 使 用 xml 
包 并 调用 了 同样 叫 作 NewDecoder 的 函数 。 这 个 函数 会 返回 一 个 指向 Decoder 值 的 指针 。 之 后 调 
用 这 个 指针 的 Decode 方法 ,传人 rssDocument 类 型 的 局 部 变量 document 的 地 址 。 最 后 返 
回 这 个 局 部 变量 的 地 址 和 Decode 方法 调用 返回 的 错误 值 。 

最 后 我 们 来 看 看 实现 了 Mat cher 接口 的 方法 ， 如 代码 清单 2-54 所 示 。 





代码 清单 2.54 matchers/rss.go: 第 69 行 到 第 112 行 


69 // Search 在 文档 中 查找 特定 的 搜索 项 
70 func (m rssMatcher) Search (feed *search.Feed, searchTerm string) 
([]*search.Result, error) { 

















Var results []*search.Result 

72 

3 log.Printf("Search Feed Type[ss] Site[%s] For Uri[l%s]\n", 
feed.Type, feed.Name, feed.URI) 

74 

75 // 获取 要 搜索 的 数据 

76 document, err := m.retrieve (feed) 

过 学 if err != nil { 

78 return nil, err 

79 } 

80 

81 for , channelItem := range document.Channel.Item { 

82 // 检查 标题 部 分 是 否 包含 搜索 项 

83 matched, err := regexp.MatchString(searchTerm, channelIltem.Title) 

84 if err != nil { 

85 return nil, err 

86 } 

87 

88 // 如 果 找 到 匹配 的 项 ， 将 其 作为 结果 保存 

89 if matched { 

90 results = append(results, &search.Resultt{ 

91 Field: "TT 

92 Content: channelIltem.Title, 

93 }) 

94 } 

95 

96 // 检查 描述 部 分 是 否 包含 搜索 项 

9:7 matched, err = regexp.MatchString(searchTerm, channelltem.Description) 

98 if err != nil { 

99 return nil, err 

100 } 

101 














102 // 如 果 找 到 匹配 的 项 ， 将 其 作为 结果 保存 








103 if matched { 

104 results = append(results, &search.Result{ 
105 Field: "Description", 

106 Content: channelItem.Description, 

107 }) 

108 } 

109 } 

10 

1 return results, nil 

112 } 


我 们 从 第 71 行 results 变量 的 声明 开始 分 析 ， 如 代码 清单 2-55 所 示 。 这 个 变量 用 于 保存 
并 返回 找到 的 结果 。 


21 Var results []*search.Result 

我 们 使 用 关键 字 var 声明 了 一 个 值 为 nil 的 切片 , 切片 每 一 项 都 是 指向 Result 类 型 值 的 指 
针 。Result 类 型 的 声明 在 之 前 match.go 代码 文件 的 第 08 行 中 可 以 找到 。 之 后 在 第 76 行 , 我 们 
使 用 刚刚 看 过 的 retrieve 方法 进行 网 络 调用 ， 如 代码 清单 2-56 所 示 。 





代码 清单 2-56 matchers/rss.go: 第 75 行 到 第 79 行 
75 // 获取 要 搜索 的 数据 


了 入 document, err := m.retrieve (feed) 
77 if err != nil { 

78 return nil, err 

29 } 





调用 retrieve 方法 返回 了 一 个 指向 rssDocument 类 型 值 的 指针 以 及 一 个 错误 值 。 之 后 ， 
像 已 经 多 次 看 过 的 代码 一 样 , 检查 错误 值 , 如 果真 的 是 一 个 错误 , 直接 返回 。 如 果 没 有 错误 发 生 ， 
之 后 会 依次 检查 得 到 的 RSS 文档 的 每 一 项 的 标题 和 描述 ， 如 果 与 搜索 项 匹配 ， 就 将 其 作为 结果 
保存 ， 如 代码 清单 2-57 所 示 。 





代码 清单 2-57 matchers/rss.go: 第 81 行 到 第 86 行 





81 for , channelItem := range document.Channel.Item { 

82 // 检查 标题 部 分 是 否 包含 搜索 项 

83 matched, err := regexp.MatchString(searchTerm, channelIltem.Title) 
84 if err != nil { 

85 return nil, err 

86 } 


既然 document .Channel.Item 是 一 个 item 类 型 值 的 切片 ,我 们 在 第 81 行 对 其 使 用 for 
range 循环 ， 依 次 访问 其 内 部 的 每 一 项 。 在 第 83 行 ， 我 们 使 用 regexp 包 里 的 MatchStzring 
函数 ， 对 channelItem 值 里 的 Title 字段 进行 搜索 ,查找 是 和 否 有 匹配 的 搜索 项 。 之 后 在 第 84 
行 检查 错误 。 如 果 没 有 错误 ， 就 会 在 第 89 行 到 第 94 行 检查 匹配 的 结果 ， 如 代码 清单 2-58 所 示 。 


代码 清单 2.58 matchers/rss.go: 第 88 行 到 第 94 行 




















88 // 如 果 找 到 匹配 的 项 ， 将 其 作为 结果 保存 

89 if matched { 

90 results = append(results, &search.Resultt{ 
91 Field: "Title", 

92 Content: channelIltem.Title, 

93 }) 

94 } 


如 果 调 用 Matchstring 方法 返回 的 matched 的 值 为 真 ， 我 们 使 用 内 置 的 append 也 
数 , 将 搜索 结果 加 入 到 results 切片 里 。append 这 个 内 置 函数 会 根据 切片 需要 , 决定 是 否 
要 增加 切片 的 长 度 和 容量 。 我 们 会 在 第 4 章 了 解 关 于 内 置 函数 append 的 更 多 知识 。 这 个 函 
数 的 第 一 个 参数 是 希望 追加 到 的 切片 ， 第 二 个 参数 是 要 追加 的 值 。 在 这 个 例子 里 ， 追 加 到 切 
片 的 值 是 一 个 指向 Result 类 型 值 的 指针 。 这 个 值 直接 使 用 字面 声明 的 方式 ， 初 始 化 为 
Result 类 型 的 值 。 之 后 使 用 取 地 址 运算 符 ( & )， 获 得 这 个 新 值 的 地 址 。 最 终 将 这 个 指针 存 
和 了 切片 。 

在 检查 标题 是 否 匹配 后 ， 第 97 行 到 第 108 行使 用 同样 的 逻辑 检查 Description 字段 。 最 
后 , 在 第 111 行 ，Search 方法 返回 了 results 作为 函数 调用 的 结果 。 























sg 小 结 





国 每 个 代码 文件 都 属于 一 个 包 ， 而 包 名 应 该 与 代码 文件 所 在 的 文件 夹 同 名 。 

国 Go 语言 提供 了 多 种 声明 和 初始 化 变量 的 方式 。 如 果 变 量 的 值 没 有 显 式 初始 化 ,编译 器 会 
将 变量 初始 化 为 零 值 。 

使 用 指针 可 以 在 函数 间或 者 goroutine 间 共 享 数 据 。 

通过 启动 goroutine 和 使 用 通道 完成 并 发 和 同步 。 

Go 语言 提供 了 内 置 函 数 来 支持 Go 语言 内 部 的 数据 结构 。 

标准 库 包 含 很 多 包 ， 能 做 很 多 很 有 用 的 事情 。 

使 用 Go 接口 可 以 编写 通用 的 代码 和 框架 。 


























第 3 曹 打包 和 工具 馆 








本 章 主要 内 容 

国 ” 如 何 组 织 Go 代码 

国 ”使 用 Go 语言 自 带 的 相关 命令 
国 ”使 用 其 他 开发 者 提供 的 工具 
图 ”与 其 他 开发 者 合作 








我 们 在 第 2 章 概览 了 Go 语言 的 语法 和 语言 结构 。 本 章 会 进一步 介绍 如 何 把 代码 组 织 成 包 ， 
以 及 如 何 操作 这 些 包 。 在 Go 语言 里 ， 包 是 个 非常 重要 的 概念 。 其 设计 理念 是 使 用 包 来 封装 不 同 
语义 单元 的 功能 。 这 样 做 ， 能 够 更 好 地 复 用 代码 ， 并 对 每 个 包 内 的 数据 的 使 用 有 更 好 的 控制 。 

在 进入 具体 细节 之 前 , 假设 读 考 已 经 熟悉 命令 行 提 示 符 , 或 者 操作 系统 的 shell, 而 且 应 该 已 
经 在 本 书 前 言 的 帮助 下 ， 安 装 了 Go。 如 果 上 面 这 些 都 准备 好 了 ， 就 让 我 们 开始 进入 细节 ， 了 解 
什么 是 包 ， 以 及 包 为 什么 对 Go 语言 的 生态 非常 重要 。 



































vse 包 


所 有 Go 语言 的 程序 都 会 组 织 成 若干 组 文件 ， 每 组 文件 被 称 为 一 个 包 。 这 样 每 个 包 的 代码 都 
可 以 作为 很 小 的 复 用 单元 , 被 其 他 项 目 引 用 。 让 我 们 看 看 标准 库 中 的 http 包 是 怎么 利用 包 的 特 
性 组 织 功 能 的 : 


net/http/ 
cgi/ 
cookiejar/ 

testdata/ 

fcgi/ 
httptest/ 
httputil/ 
pprof/ 
testdata/ 


这 些 目 录 包 括 一 系列 以 .go 为 扩展 名 的 相关 文件 。 这 些 目录 将 实现 HTTP 服务 器 、 客 户 端 、 

















测试 工具 和 性 能 调试 工具 的 相关 代码 拆 分 成 功能 清晰 的 、 小 的 代码 单元 。 以 cookiejar 包 为 例 ， 
这 个 包 里 包含 与 存储 和 获取 网 页 会 话 上 的 cookie 相关 的 代码 。 每 个 包 都 可 以 单独 导入 和 使 用 ， 以 
便 开 发 者 可 以 根据 自己 的 需要 导入 特定 功能 。 例 如 ,如果 要 实现 HITP 客户 端 ， 只 需要 导入 http 
包 就 可 以 。 

所 有 的 .go 文件 ， 除 了 空 行 和 注释 ， 都 应 该 在 第 一 行 声明 自己 所 属 的 包 。 每 个 包 都 在 一 个 单 
独 的 目录 里 ,不 能 把 多 个 包 放 到 同一 个 目录 中 ,也 不 能 把 同一 个 包 的 文件 分 拆 到 多 个 不 同 目录 中 。 
这 意味 着 ， 同 一 个 目录 下 的 所 有 .go 文件 必须 声明 同一 个 包 名 。 




















3.1.1 包 名 惯例 


给 包 命 名 的 惯例 是 使 用 包 所 在 目录 的 名 字 。 这 让 用 户 在 导入 包 的 时 候 ， 就 能 清晰 地 知道 包 名 。 
我 们 继续 以 net /http 包 为 例 , 在 http 目录 下 的 所 有 文件 都 属于 http 包 。 给 包 及 其 目录 命名 
时 ,应 该 使 用 简洁 、 清 晰 且 全 小 写 的 名 字 , 这 有 利于 开发 时 频繁 输入 包 名 。 例 如 ，net/http 包 
下 面 的 包 ,， 如 cgi、httputil 和 pprof， 名 字 都 很 简洁 。 

记 住 , 并 不 需要 所 有 包 的 名 字 都 与 别 的 包 不 同 , 因为 导入 包 时 是 使 用 全 路 径 的 , 所 以 可 以 区 分 
同名 的 不 同 包 。 一般 情况 下 , 包 被 导入 后 会 使 用 你 的 包 名 作为 默认 的 名 字 , 不 过 这 个 导入 后 的 名 字 
可 以 修改 。 这 个 特性 在 需要 导入 不 同 目录 的 同名 包 时 很 有 用 。3.2 节 会 展示 如 何 修改 导 和 人 的 包 名 。 

















3.1.2 main 包 


在 Go 语言 里 , 命名 为 main 的 包 具 有 特殊 的 含义 。Go 语言 的 编译 程序 会 试图 把 这 种 名 字 的 
包 编 译 为 二 进 制 可 执行 文件 。 所 有 用 Go 语言 编译 的 可 执行 程序 都 必须 有 一 个 名 叫 main 的 包 。 

当 编 译 澡 发 现 某 个 包 的 名 字 为 main 时 , 它 一 定 也 会 发 现 名 为 main () 的 函数 , 否则 不 会 创建 
可 执行 文件 。main () 函数 是 程序 的 入 口 ， 所 以 ， 如 果 没 有 这 个 函数 ， 程 序 就 没有 办 法 开始 执行 。 
程序 编译 时 ， 会 使 用 声明 main 包 的 代码 所 在 的 目录 的 目录 名 作为 二 进 制 可 执行 文件 的 文件 名 。 





命令 和 包 Go 文档 里 经 常 使 用 命令 (command ) 这 个 词 来 指 代 可 执行 程序 ， 如 命令 行 应 用 程序 。 
这 会 让 新 手 在 阅读 文档 时 产生 困惑 。 记 住 ， 在 Go 语言 里 ， 命 令 是 指 任何 可 执行 程序 。 作 为 对 比 ， 
包 更 常用 来 指 语义 上 可 导入 的 功能 单元 。 


让 我 们 来 实际 体验 一 下 。 首先, 在 $GOPATH/src/hello/ 目 录 里 创建 一 个 叫 hello.go 的 文件 , 并 
输入 代码 清单 3-1 里 的 内 容 。 这 是 个 经 典 的 “Hello World!” 程 序 , 不 过 , 注意 一 下 包 的 声明 以 及 


import 语句 。 




















代码 清单 3-1 ”经典 的 “Hello World!” 程 序 

















01 Package main 本 
fmt 包 提供 了 完成 
03 import "fmt" = 格式 化 输出 的 功能 。 


04 

05 func main() { 

06 fmt.Println("Hello World!") 
07 } 


获取 包 的 文档 ” 别 忘 了 ， 可 以 访问 http://golang.org/pkg/fmt/ 或 者 在 终端 输入 godoc fmt 来 了 解 更 
多 关于 fmt 包 的 细节 。 


保存 了 文件 后 ， 可 以 在 $GOPATH/src/hello/ 目 录 里 执行 命令 go build。 这 条 命令 执行 完 
后 ,会 生成 一 个 二 进 制 文件 。 在 UNIX、Linux 和 Mac OS X 系统 上 ， 这 个 文件 会 命名 为 hello， 
而 在 Windows 系统 上 会 命名 为 hello.exe。 可 以 执行 这 个 程序 ， 并 在 控制 台 上 显示 “Hello 
World! 。 

如 果 把 这 个 包 名 改 为 main 之 外 的 某 个 名 字 , 如 hello，, 编译 器 就 认为 这 只 是 一 个 包 , 而 不 
是 命令 ， 如 代码 清单 3-2 所 示 。 





代码 清单 3-2 包含 main 函数 的 无 效 的 Go 程序 





01 package hello 
03 import "fmt" 
05 func main(){ 


06 fmt.Println("Hello, World!") 
07 } 


VD 导入 


我 们 已 经 了 解 如 何 把 代码 组 织 到 包 里 , 现在 让 我 们 来 看 看 如 何 导 入 这 些 包 , 以 便 可 以 访问 包 
内 的 代码 。import 语句 告诉 编译 器 到 磁盘 的 哪里 去 找 想 要 导入 的 包 。 导 入 包 需 要 使 用 关键 字 
import， 它 会 告诉 编译 器 你 想 引 用 该 位 置 的 包 内 的 代码 。 如 果 需 要 导入 多 个 包 ， 习 惯 上 是 将 
import 语句 包装 在 一 个 导入 块 中 ， 代 码 清单 3-3 展示 了 一 个 例子 。 


代码 清单 3-3 ”import 声明 块 


























import ( strings 包 提 供 了 很 多 关于 字符 串 的 操作 ， 如 查找 、 蔡 换 或 
Ie 者 变换 。 可 以 通过 访问 http://golang.org/pkg/strings/ 或 者 在 终端 
strings “运行 godoc strings 来 了 解 更 多 关于 strings 包 的 细节 。 





) 
编译 器 会 使 用 Go 环境 变量 设置 的 路 径 ， 通 过 引入 的 相对 路 径 来 查找 磁盘 上 的 包 。 标 准 库 中 
的 包 会 在 安装 Go 的 位 置 找 到 。Go 开发 者 创建 的 包 会 在 GOPATH 环境 变量 指定 的 目录 里 查找 。 
GOPATH 指定 的 这 些 目录 就 是 开发 者 的 个 人 工作 空间 。 
举 个 例子 。 如 果 Go 安装 在 /usr/local/go， 并 且 环 境 变 量 GOPATH 设置 为 /home/myproject:/home/ 
mylibraries ， 编 译 器 就 会 按照 下 面 的 顺序 查找 net/http 包 : 








/usr/local/go/src/pkg/net/http 这 就 是 标准 库 源 
/home/myproject/src/net/http 代码 所 在 的 位 置 。 
/home/mylibraries/src/net/http 


一 旦 编译 需 找到 一 个 满足 import 语句 的 包 , 就 停止 进一步 查找 。 有 一 件 重要 的 事 需 要 记 
住 ， 编 译 需 会 首先 查找 Go 的 安装 目录 ， 然 后 才 会 按 顺 序 查 找 GOPATH 变量 里 列 出 的 目录 。 

如 果 编 译 需 查 志 GOPATH 也 没有 找到 要 导入 的 包 ， 那 么 在 试图 对 程序 执行 run 或 者 build 
的 时 候 就 会 出 错 。 本 音 后 面 会 介绍 如 何 通 过 go get 命令 来 修正 这 种 错误 。 








3.2.1 远程 导入 


目前 的 大 势 所 趋 是 ， 使 用 分 布 式 版 本 控制 系统 ( Distributed Version Control Systems DVCS ) 
来 分 享 代 码 ， 如 GitHub 、Launchpad 还 有 Bitbucket。Go 语言 的 工具 链 本 身 就 支持 从 这 些 网 站 及 
类 似 网 站 获取 源 代码 。Go 工具 链 会 使 用 导入 路 径 确 定 需要 获取 的 代码 在 网 络 的 什么 地 方 。 

例如 : 

import "github.com/spf1l3/viper" 

用 导入 路 径 编译 程序 时 , go build 命令 会 使 用 GOPATH 的 设置 , 在 磁盘 上 搜索 这 个 包 , 事实 上 ， 
这 个 导入 路 径 代表 一 个 URL， 指 向 GitHub 上 的 代码 库 。 如 果 路 径 包 含 URL， 可 以 使 用 Go 工具 链 从 
DVCS 获取 包 ， 并 把 包 的 源 代码 保存 在 GOPATH 指向 的 路 径 里 与 URL 匹配 的 目录 里 。 这 个 获取 过 程 
使 用 go get 命令 完成 。go get 将 获取 任意 指定 的 URL 的 包 ， 或 者 一 个 已 经 导入 的 包 所 依赖 的 其 
他 包 。 由 于 go get 的 这 种 递归 特性 ， 这 个 命令 会 扫描 某 个 包 的 源码 树 ， 获 取 能 找到 的 所 有 依赖 包 。 






































3.2.2 命名 导入 


如 果 要 导入 的 多 个 包 具 有 相同 的 名 字 ， 会 发 生 什么 ?例如 ， 既 需要 network/convert 包 
来 转换 从 网 络 读 取 的 数据 ， 又 需要 file/convert 包 来 转换 从 文本 文件 读 取 的 数据 时 ， 就 会 同 
时 导入 两 个 名 叫 convert 的 包 。 这 种 情况 下 ， 重 名 的 包 可 以 通过 命名 导入 来 导入 。 命 名 导入 是 
指 ， 在 import 语句 给 出 的 包 路 径 的 左 侧 定义 一 个 名 字 ， 将 导入 的 包 命 名 为 新 名 字 。 

例如 ， 若 用 户 已 经 使 用 了 标准 库 里 的 fmt 包 ， 现 在 要 导入 自己 项 目 里 名 叫 fmt 的 包 ， 就 可 
以 通过 代码 清单 3-4 所 示 的 命名 导入 方式 ， 在 导入 时 重新 命名 自己 的 包 。 








代码 清单 3-4” 重 命名 导入 


01 package main 


02 

03 import ( 

04 ”fmt” 

05 myfmt "mylib/fmt" 
06 ) 

07 


08 func main() { 


3.3 函数 init 41 


09 fmt.Println("Standard Library") 
10 myfmt .Println ("mylib/fmt") 
二 二 滞 














当 你 导入 了 一 个 不 在 代码 里 使 用 的 包 时 ，Go 编译 器 会 编译 失败 ， 并 输出 一 个 错误 。Go 开发 
队 认 为 ， 这 个 特性 可 以 防止 导入 了 未 被 使 用 的 包 , 避免 代码 变 得 腾 肿 。 虽 然 这 个 特性 会 让 人 觉 
得 很 烦 ,但 Go 开发 团队 仍然 花 了 很 大 的 力气 说 服 自己 ,决定 加 入 这 个 特性 ， 用 来 避免 其 他 编程 
语言 里 常常 遇 到 的 一 些 问 题 , 如 得 到 一 个 塞 满 未 使 用 库 的 超大 可 执行 文件 。 很 多 语言 在 这 种 情况 
会 使 用 警告 做 提示 ， 而 Go 开发 团队 认为 ， 与 其 让 编译 右 告 营 ， 不 如 直接 失败 更 有 意义 。 每 个 编 
译 过 大 型 C 程序 的 人 都 知道 ， 在 浩如烟海 的 编译 器 警告 里 找到 一 条 有 用 的 信息 是 多 么 困难 的 一 件 
事 。 这 种 情况 下 编译 失败 会 更 加 明确 。 

有 时 ,用 户 可 能 需要 导入 一 个 包 , 但 是 不 需要 引用 这 个 包 的 标识 符 。 在 这 种 情况 ,可 以 使 用 
空白 标识 符 来 重 命名 这 个 导入 。 我 们 下 节 会 讲 到 这 个 特性 的 用 法 。 

空白 标识 符 ”下划线 字符 (_) 在 Go 语言 里 称 为 室 白 标识 符 ， 有 很 多 用 法 。 这 个 标识 符 用 来 抛弃 不 

想 继续 使 用 的 值 ， 如 给 导入 的 包 赋 予 一 个 空 名 字 ， 或 者 忽略 函数 返回 的 你 不 感 兴趣 的 值 。 
















































































3.3 函数 init 

每 个 包 可 以 包含 任意 多 个 init 函数 , 这 些 函 数 都 会 在 程序 执行 开始 的 时 候 被 调用 。 所 有 被 
编译 器 发 现 的 init 函数 都 会 安排 在 main 函数 之 前 执行 。init 函数 用 在 设置 包 、 初 始 化 变量 
或 者 其 他 要 在 程序 运行 前 优先 完成 的 引导 工作 。 

以 数据 库 驱 动 为 例 ，database 下 的 驱动 在 启动 时 执行 init 函数 会 将 自身 注册 到 sql 包 
里 ， 因 为 sql 包 在 编译 时 并 不 知道 这 些 驱 动 的 存在 ， 等 启动 之 后 sql 才能 调用 这 些 驱动 。 让 我 
们 看 看 这 个 过 程 中 init 函数 做 了 什么 ， 如 代码 清单 3-5 所 示 。 



































代码 清单 3-5 init 函数 的 用 法 





01 package postgres 








02 

03 import ( 

和 database/sql 创建 一 个 postgres 驱动 的 
06 实例 。 这 里 为 了 展现 init 的 
07 func init() { 作用 ， 没 有 展现 其 定义 细节 。 
08 SqlLl.Register ("postdgres"，new(PostgresDriver) ) < 一 一 

0.9: 





这 上段 示例 代码 包含 在 PostgreSQL 数据 库 的 驱动 里 。 如 果 程 序 导 入 了 这 个 包 , 就 会 调用 init 
函数 ， 促 使 PostgreSQL 的 驱动 最 终 注 册 到 Go 的 sql 包 里 ,成 为 一 个 可 用 的 驱动 。 

在 使 用 这 个 新 的 数据 库 驱 动 写 程序 时 , 我 们 使 用 空白 标识 符 来 导入 包 , 以 便 新 的 驱动 会 包含 
到 sql 包 。 如 前 所 述 , 不 能 导入 不 使 用 的 包 , 为 此 使 用 空白 标识 符 重 命名 这 个 导入 可 以 让 init 
函数 发 现 并 被 调度 运行 ， 让 编译 器 不 会 因为 包 未 被 使 用 而 产生 错误 。 























现在 我 们 可 以 调用 sql .open 方法 来 使 用 这 个 驱动 ， 如 代码 清单 3-6 所 示 。 


代码 清单 3-6 ”导入 时 使 用 空白 标识 符 作为 包 的 别名 





01 package main 














02 

03 import ( 使 用 空白 标识 符 导入 

04 "database/sql" 包 ， 避 免 编译 错误 

05 ， 

06 _ "github.com/goinaction/code/chapter3/dbdriver/postgres" 号 

07 ) 

08 | 调用 sql 包 提供 的 open 方法。 该 方法 能 

| Bane We edi 工作 的 关键 在 于 postgres 驱动 通过 自 
sql. ostgres", "my i 二 

11 } 己 的 init 函数 将 自身 注册 到 了 sql 包 。 








v 使 用 如 的 工具 


在 前 几 章 里 ， 我 们 已 经 使 用 过 了 go 这 个 工具 ， 但 我 们 还 没有 探讨 这 个 工具 都 能 做 哪些 事情 。 
让 我 们 进一步 深入 了 解 这 个 短小 的 命令 , 看 看 都 有 哪些 强大 的 能 力 。 在 命令 行 提 示 符 下 , 不 带 参 
数 直接 键入 go 这 个 命令 : 

$ go 

go 这 个 工具 提供 了 很 多 功能 ， 如 图 3-1 所 示 。 


The commands are: 























build compile packages and dependencies 

clean remove object files 

doc show documentation for package or symbol 

env print Go _ environment information 

fix run go tool fix on packages 

fmt run gofmt on package sources 

generate generate Go files by processing Source 

Eet download and install packages and dependencies 
install [0 
list list packages 

run compiLe and run Go program 

test test packages 

tool run specified go tool 

version print Go version 

vet run go tool vet on packages 


Use "go help [command]" for more information about a command . 
Additional help topics: 


c caLtLing between Go and 上 
buildmode “ description of build modes 
filetype file types 

gopath GOPATH environment variable 
importpath import path syntax 

packages description of package lists 
testflag description of testing flags 
testfunc description of testing functions 





Use "go help [topic]" for more information about that topic。 
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通过 输出 的 列表 可 以 看 到 ， 这 个 命令 包含 一 个 编译 器 ， 这 个 编译 器 可 以 通过 build 命令 启 
动 。 正 如 预料 的 那样 ，build 和 clean 命令 会 执行 编译 和 清理 的 工作 。 现 在 使 用 代码 清单 3-2 
里 的 源 代码 ， 尝 试 执行 这 些 命令 : 

go build hello.go 

当 用 户 将 代码 签 入 源码 库 里 的 时 候 ， 开 发 人 员 可 能 并 不 想 签 入 编译 生成 的 文件 。 可 以 月 
clean 命令 解决 这 个 问题 : 

go clean hello.go 

调用 clean 后 会 删除 编译 生成 的 可 执行 文件 。 让 我 们 看 看 ge 工具 的 其 他 一 些 特性 ， 以 
及 使 用 这 些 命令 时 可 以 节省 时 间 的 方法 。 接 下 来 的 例子 中 ， 我 们 会 使 用 代码 清单 3-7 中 的 样 
例 代 码 。 


代码 清单 3-7 使 用 io 包 的 工作 


01 package main 





i 























02 
03, 1mpOrFt, A( 
04 区 
05 viG/LoutiL" 
06 "os™ 
07 
08 "github.com/goinaction/code/chapter3/words" 
09 ) 
10 
11 // main 是 应 用 程序 的 入 
2 func main() { 
3 filename := os.Args[1] 
14 
15 contents, err := ioutil.ReadFile (filename) 
6 if err != nil { 
fmt .Println (err) 
18 return 
19 } 
20 
21 text := string (contents) 
22 
23 count := words.CountWords (text) 
24 fmt.Printf ("There are %d words in your text. \n", count) 
251 中 


如 果 已 经 下 载 了 本 书 的 源 代码 , 应 该 可 以 在 SGOPATH/src/github.com/goinaction/code/chapter3/words 
找到 这 个 包 。 确保 已 经 有 了 这 段 代码 再 进行 后 面 的 内 容 。 

大 部 分 Go 工具 的 命令 都 会 接受 一 个 包 名 作为 参数 。 回 顾 一 下 已 经 用 过 的 命令 ,会 想起 build 
命令 可 以 简写 。 在 不 包含 文件 名 时 ，go 工具 会 默认 使 用 当前 目录 来 编译 。 

go build 


因为 构建 包 是 很 常用 的 动作 ， 所 以 也 可 以 直接 指定 包 : 




















go build github.com/goinaction/code/chapter3/wordcount 
也 可 以 在 指定 包 的 时 候 使 用 通配符 。3 个 点 表示 匹配 所 有 的 字符 串 。 例 如 ， 下 面 的 命令 会 编译 
chapter3 目录 下 的 所 有 包 : 

go build github.com/goinaction/code/chapter3/... 

除了 指定 包 ， 大 部 分 Go 命令 使 用 短路 径 作 为 参数 。 例 如 ， 下 面 两 条 命令 的 效果 相同 : 


go build wordcount .go 





go build . 
要 执行 程序 ， 需 要 首先 编译 ， 然 后 执行 编译 创建 的 wordcount 或 者 wordcount .exe 程 
不 过 这 里 有 一 个 命令 可 以 在 一 次 调用 中 完成 这 两 个 操作 : 
go run wordcount .go 
go run 命令 会 先 构建 wordcount.go 里 包含 的 程序 ， 然 后 执行 构建 后 的 程序 。 这 样 可 以 节省 
好 多 录入 工作 量 。 

做 开发 会 经 常 使 用 go puild 和 go run 命令 。 让 我 们 看 另外 几 个 可 用 的 命令 ,以 及 这 些 
命令 可 以 做 什么 。 
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VX 进一步 介绍 名 开发 工具 


我 们 已 经 学 到 如 何 用 go 这 个 通用 工具 进行 编译 和 执行 。 但 这 个 好 用 的 工具 还 有 很 多 其 他 没 
有 介绍 的 诀 容 。 




















3.5.1 go vet 


这 个 命令 不 会 帮 开 发 人 员 写 代码 , 但 如 果 开 发 人 员 已 经 写 了 一 些 代码 , vet 命令 会 帮 开 发 人 
员 检 测 代码 的 常见 错误 。 让 我 们 看 看 vet 捕获 哪些 类 型 的 错误 。 

图 Printf 类 函数 调用 时 ， 类 型 匹配 错误 的 参数 。 

加 定义 常用 的 方法 时 ， 方法 签名 的 错误 。 

图 错误 的 结构 标签 。 

加 没有 指定 字段 名 的 结构 字面 量 。 

让 我 们 看 看 许多 Go 开发 新 手 经 常 犯 的 一 个 错误 。fmt .Printf 函数 党 用 来 产生 格式 化 输出 ， 
不 过 这 个 函数 要 求 开 发 人 员 记 住所 有 不 同 的 格式 化 说 明 符 。 代 码 清单 3-8 中 给 出 的 就 是 一 个 例子 。 


代码 清单 3-8 ”使 用 go vet 


01 package main 
02 
03 import "fmt" 
04 








05 func main() { 
06 fmt.Printf("The quick brown fox jumped over lazy dogs", 3.14) 
07 } 


这 个 程序 要 输出 一 个 浮 点 数 3.14, 但 是 在 格式 化 字符 串 
这 上段 代码 执行 go vet ,会 得 到 如 下 消息 : 


go vet main.go 








并 没有 对 应 的 格式 化 参数 。 如 果 对 


um 














main.go:6: no formatting directive in Printf call 

go vet 工具 不 能 让 开发 者 避免 严重 的 逻辑 错误 ， 或 者 避免 编写 充满 小 错 的 代码 。 不 过 ,， 正 
像 刚才 的 实例 中 展示 的 那样 ， 这 个 工具 可 以 很 好 地 捕获 一 部 分 常见 错误 。 每 次 对 代码 先 执行 go 
vet 再 将 其 签 和 人 源 代码 库 是 一 个 很 好 的 习惯 。 















































3.5.2 ”Go 代码 格式 化 


fmt 是 Go 语言 社区 很 喜欢 的 一 个 命令 。fmt 工具 会 将 开发 人 员 的 代码 布局 成 和 Go 源 代码 
类 似 的 风格 ,不 用 再 为 了 大 括号 是 不 是 要 放 到 行 尾 ,或 者 用 tab( 制 表 符 ) 还 是 空格 来 做 缩 进 而 
争论 不 休 。 使 用 go fmt 后 面 跟 文件 名 或 者 包 名 ， 就 可 以 调用 这 个 代码 格式 化 工具 。fmt 命令 会 
自动 格式 化 开发 人 员 指 定 的 源 代 码 文件 并 保存 。 下 面 是 一 个 代码 执行 go fmt 前 和 执行 go fmt 
后 几 行 代码 的 对 比 : 










































































if err != nil { return err } 
在 对 这 段 代码 执行 go fmt 后 ,会 得 到 : 
if err != nil { 


return err 


} 
很 多 Go 开发 人 员 会 配置 他 们 的 开发 环境 ， 在 保存 文件 或 者 提交 到 代码 库 前 执行 go fmt 。 
如 果 读 者 喜欢 这 个 命令 ， 也 可 以 这 样 做 。 








3.5.3 Go 语言 的 文档 

还 有 另外 一 个 工具 能 让 Go 开发 过 程 变 简单 。Go 语言 有 两 种 方法 为 开发 者 生成 文档 。 如 果 
开发 人 员 使 用 命令 行 提 示 符 工作 ， 可 以 在 终端 上 直接 使 用 go doc 命令 来 打印 文档 。 无 需 离 开 终 
端 ， 即 可 快速 浏览 命令 或 者 包 的 帮助 。 不 过 ， 如 果 开 发 人 员 认 为 一 个 浏览 器 界面 会 更 有 效率 ， 可 
以 使 用 godoc 程序 来 启动 一 个 Web 服务 器 ， 通 过 点 击 的 方式 来 查看 Go 语言 的 包 的 文档 。Web 
服务 器 godoc 能 让 开发 人 员 以 网 页 的 方式 浏览 自己 的 系统 里 的 所 有 Go 语言 源 代码 的 文档 。 
1. 从 命令 行 获取 文档 

对 那 种 总 会 打开 一 个 终端 和 一 个 文本 编辑 器 (或 者 在 终端 内 打开 文本 编辑 器 ) 的 开发 人 员 来 



































说 ，go doc 是 很 好 的 选择 。 假 设 要 用 Go 语言 第 一 次 开发 读 取 UNIX tar 文件 的 应 用 程序 ， 想 


要 看 看 archive/tar 包 的 相关 文档 ， 就 可 以 输入 : 
go doc tar 
执行 这 个 命令 会 直接 在 终端 产生 如 下 输出 : 


PACKAGE DOCUMENTATION 








package tar // import "archive/tar" 


Package tar implements access to tar archives. It aims to cover most of the 


variations, including those produced by GNU and BSD tars 
References: 


http://www.freebsd.org/cgi/man.cgi?query=tar&sektion 


= 


http://www.gnu.org/software/tar/manual/html nodqe/Standard.html 


http://pubs.opengroup.org/onlinepubs/9699919799/util 
Var ErrWriteTooLong = errors.New("archive/tar: write 七 Do 
Var ErrHeader = errors.New("archive/tar: invalid 七 ar hea 
func FileInfoHeader (fi os.FileInfo, link string) (*Heade 
func NewReader(r io.Reader) *Reader 
func NewWriter(w io.Writer) *Writer 


type Header struct { ... } 
type Reader struct { ... } 
type Writer struct { ... } 








ities/pax.html 
Long”™ 站 aw 

der") 

r, error) 


开发 人 员 无 需 离 开 终端 即 可 直接 翻 看 文档 ， 找 到 自己 需要 的 部 分 。 


2. 浏览 文档 


Go 语言 的 文档 也 提供 了 浏览 器 版 本 。 有 时 候 ， 通 过 跳 转 到 文档 ， 查 阅 相 关 的 细节 ， 能 更 容 
易 理 解 整 个 包 或 者 菏 个 函数 。 在 这 种 情况 下 , 会 想 使 用 godoc 作为 Web 服务 器 。 如 有 果 想 通过 Web 
浏览 器 查看 可 以 点 击 跳 转 的 文档 ， 下 面 就 是 得 到 这 种 文档 的 好 方式 。 














开发 人 员 启 动 自己 的 文档 服务 器 ， 只 需要 在 终端 会 话 中 输入 如 
godoc -http=:6060 


这 个 命令 通知 godoc 在 端口 6060 启动 Web 服务 器 。 如 





下 命令 : 





果 浏 览 絮 已 经 打开 ， 导航 到 


http://localhost:6060 可 以 看 到 一 个 页 面 , 包含 所 有 Go 标准 库 和 你 的 GOPATH 下 的 Go 源 代码 的 文档 。 
如 果 图 3-2 显示 的 文档 对 开发 人 员 来 说 很 熟悉 , 并 不 奇怪 , 因为 Go 官网 就 是 通过 一 个 略 
微 修 改过 的 godoc 来 提供 文档 服务 的 。 要 进入 某 个 特定 包 的 文档 ， 只 需要 点 击 页 面 顶 端的 














Packages。 








Go 文档 工具 最 棒 的 地 方 在 于 ， 它 也 支持 开发 人 员 自己 写 的 代码 。 如 果 开 发 人 员 遵 从 一 个 简 


单 的 规则 来 写 代 码 ， 这 些 代码 就 会 自动 包含 在 godoc 生成 的 文档 


日 


oo 





为 了 在 godoc 生成 的 文档 里 包含 自己 的 代码 文档 ， 开 发 人 员 需 要 用 下 面 的 规则 来 写 代 码 和 











注释 。 我 们 不 会 在 本 章 介绍 所 有 的 规则 ， 只 会 提 一 些 重要 的 规则 。 
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Go is an open source programming language 
that makes it easy to build simple, reliable, and 
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图 3-2 本 地 Go 文档 
用 户 需 要 在 标识 符 之 前 ， 把 自己 想 要 的 文档 作为 注释 加 入 到 代码 中 。 这 个 规则 对 包 、 瑞 数 、 
类 型 和 全 局 变量 都 适用 。 注 释 可 以 以 双 斜 线 开 头 ， 也 可 以 用 斜 线 和 星 号 风格 。 


// Retrieve 连接 到 配置 库 ， 收 集 各 种 链接 设置 、 用 户 名 和 密码 。 这 个 函数 在 成 功 时 
// 返回 config 结构 ， 和 否则 返回 一 个 错误 。 
























































func Retrieve() (config, error) { 
// ... 省 略 


} 
在 这 个 例子 里 , 我们 展示 了 在 Go 语言 里 为 一 个 函数 写 文档 的 惯用 方法 。 函 数 的 文档 直接 写 
在 函数 声明 之 前 , 使 用 人 类 可 读 的 句子 编写 。 如 果 想 给 包 写 一 段 文 字 量 比较 大 的 文档 ,可 以 在 工 
程 里 包含 一 个 叫 作 doc.go 的 文件 ,使 用 同样 的 包 名 ， 并 把 包 的 介绍 使 用 注释 加 在 包 名 声明 之 前 。 
/* 






































于 调 








USB 设备 的 类 型 和 函数 。 想 要 与 USB 设备 创建 一 个 新 链接 ， 使 用 NewConnection 











包 usb 提供 


*/ 

package usb 

这 段 关 于 包 的 文档 会 显示 在 所 有 类 型 和 函数 文档 之 前 。 这 个 例子 也 展示 了 如 何 使 用 斜 线 和 星 
号 做 注释 。 可 以 在 Google 上 搜索 golang documentation 来 查找 更 多 关于 如 何 给 代码 创建 一 个 好 文 
档 的 内 容 。 








v 听 ”与 其 他 如 开发 者 合作 


现代 开发 者 不 会 一 个 人 单打 独 斗 ， 而 Go 工具 也 认可 这 个 趋 热 ， 并 为 合作 提供 了 支持 。 多 亏 
了 go 工具 链 , 包 的 概念 没有 被 限制 在 本 地 开发 环境 中 , 而 是 做 了 扩展 , 从 而 支持 现代 合作 方式 。 
让 我 们 看 看 在 分 布 式 开发 环境 里 ， 想 要 良好 合作 ， 需 要 遵守 的 一 些 惯例 。 









































以 分 享 为 目的 创建 代码 库 

开发 人 员 一 旦 写 了 些 非 常 棒 的 Go 代码 ， 就 会 很 想 把 这 些 代码 与 Go 社区 的 其 他 人 分 享 。 这 
其 实 很 容易 ， 只 需要 执行 下 面 的 步 又 就 可 以 。 
1. 包 应 该 在 代码 库 的 根 目 录 中 


使 用 go get 的 时 候 ， 开 发 人 员 指 定 了 要 导入 包 的 全 路 径 。 这 意味 着 在 创建 想 要 分 享 的 代码 
库 的 时 候 ， 包 名 应 该 就 是 代码 库 的 名 字 ， 而 且 包 的 源 代码 应 该 位 于 代码 库 目 录 结 构 的 根 目录 。 

Go 语言 新 手 常 犯 的 一 个 错误 是 ， 在 公用 代码 库 里 创建 一 个 名 为 code 或 者 src 的 目录 。 如 
果 这 么 做 , 会 让 导入 公用 库 的 语句 变 得 很 长 。 为 了 避免 过 长 的 语句 ， 只 需要 把 包 的 源 文件 放 在 公 
用 代码 库 的 根 目 录 就 好 。 


2. 包 可 以 非常 小 


与 其 他 语言 相 比 ，Go 语言 的 包 一 般 相 对 较 小 。 不 要 在 意 包 只 支持 几 个 API， 或 者 只 完成 一 
项 任务 。 在 Go 语言 里 ， 这 样 的 包 很 常见 ， 而 且 很 受 欢迎 。 


3， 对 代码 执行 go fmt 

和 其 他 开源 代码 库 一 样 ， 人 们 在 试用 代码 前 会 通过 源 代码 来 判断 代码 的 质量 。 开 发 人 员 需 要 
在 签 人 代码 前 执行 go fmt , 这 样 能 让 自己 的 代码 可 读 性 更 好 , 而 且 不 会 由 于 一 些 字符 的 干扰 (如 
制 表 符 )， 在 不 同人 的 计算 机 上 代码 显示 的 效果 不 一 样 。 
4. 给 代码 写 文档 


Go 开发 者 用 godoc 来 阅读 文档 , 并 且 会 用 http://godoc.org 这 个 网 站 来 阅读 开源 包 的 文档 。 如 果 
按照 go doc 的 最 佳 实践 来 给 代码 写 文档 ， 包 的 文档 在 本 地 和 线 上 都 会 很 好 看 ， 更 容易 被 别人 发 现 。 



















































































v 尖 ”依赖 管理 


从 Go 1.0 发 布 那天 起 , 社区 做 了 很 多 努力 , 提供 各 种 Go 工具 , 以 便 开发 人 员 的 工作 更 轻松 。 
有 很 多 工具 专注 在 如 何 管理 包 的 依赖 关系 。 现 在 最 流行 的 依赖 管理 工具 是 Keith Rarik 写 的 godep、 








Daniel Theophanes 写 的 vender 和 Gustavo Niemeyer 开发 的 gopkg.in 工具 。gopkg.in 能 帮助 开发 人 
员 发 布 自己 的 包 的 多 个 版 本 。 

作为 对 社区 的 回应 ，Go 语言 在 1.5 版 本 开始 试验 性 提供 一 组 新 的 构建 选项 和 功能 ， 来 为 依 
赖 管理 提供 更 好 的 工具 支持 。 尽 管 我 们 还 需要 等 一 段 时 间 才 能 确认 这 些 新 特性 是 否 能 达成 目的 ， 
但 毕 竞 现在 已 经 有 一 些 工 具 以 可 重复 使 用 的 方式 提供 了 管理 、 构 建 和 测试 Go 代码 的 能 力 。 



































3.7.1 第 三 方 依赖 


像 godep 和 vender 这 种 社区 工具 已 经 使 用 第 三 方 ( verdoring ) 导入 路 径 重 写 这 种 特性 解决 了 
依赖 问题 。 其 思想 是 把 所 有 的 依赖 包 复 制 到 工程 代码 库 中 的 目录 里 , 然后 使 用 工程 内 部 的 依赖 包 
所 在 目录 来 重 写 所 有 的 导入 路 径 。 

代码 清单 3-9 展示 的 是 使 用 godep 来 管理 工程 里 第 三 方 依赖 时 的 一 个 典型 的 源 代码 树 。 


代码 清单 3-9 使 用 godep 的 工程 


$SGOPATH/src/github.com/ardanstudios/myproject 











-— Godeps 
|-- Godeps.json 
|-- Readme 
|-- _workspace 
|-- src 
-— bitbucket .org 
一 一 WwW 
|-- goautoneg 
|-- Makefile 
|-- README .txt 
|-- autoneg.go 
|-- autoneg test.go 
-— github.com 
|-- beorn7 
|-- perks 
|-- README .md 
|-- quantile 
|-- bench test.go 
|-- example test.go 
|-- exampledata.txt 
|-- stream.go 
-— examples 
-—- model 
—— README .md 
-— main.go 


可 以 看 到 godep 创建 了 一 个 叫 作 Godeps 的 目录 。 由 这 个 工具 管理 的 依赖 的 源 代码 被 放 在 
一 个 叫 作 _workspace/src 的 目录 里 。 

接 下 来 ， 如 果 看 一 下 在 main.go 里 声明 这 些 依赖 的 import 语句 ( 如 代码 清单 3-9 和 代码 清 
单 3-10 所 示 )， 就 能 发 现 需 要 改动 的 地 方 。 


代码 清单 3-10 ”在 路 径 重 写 之 前 


01 package main 


02 

03 import ( 

04 "bitbucket .org/ww/goautoneg" 
05 "github.com/beorn7/perks" 
06 ) 


代码 清单 3-11 在 路 径 重 写 之 后 


01 package main 


02 
03. import. .( 
04 "github.ardanstudios.com/myproject/Godeps/ workspace/src/ 
bitbucket .org/ww/goautoneg" 
05 "github.ardanstudios.com/myproject/Godeps/ workspace/src/ 
github.com/beorn7/perks" 
06 ) 


在 路 径 重 写 之 前 ,， import 语句 使 用 的 是 包 的 正常 路 径 。 包 对 应 的 代码 存放 在 GOPATH 所 指 
定 的 磁盘 目录 里 。 在 依赖 管理 之 后 ， 导 和 路径 需要 重 写成 工程 内 部 依赖 包 的 路 径 。 可 以 看 到 这 些 
导 和 人 路 径 非 常 长 ， 不 易于 使 用 。 

引入 依赖 管理 将 所 有 构建 时 依赖 的 源 代码 都 导入 到 一 个 单独 的 工程 代码 库 里 ， 可 以 更 容易 地 重 
新 构建 工程 。 使 用 导入 路 径 重 写 管理 依赖 包 的 男 外 一 个 好 处 是 这 个 工程 依旧 支持 通过 go get 获取 
代码 库 。 当 获取 这 个 工程 的 代码 库 时 , go get 可 以 找到 每 个 包 , 并 将 其 保存 到 工程 里 正确 的 目录 中 。 

















3.7.2 对 gb 的 介绍 


gb 是 一 个 由 Go 社区 成 员 开 发 的 全 新 的 构建 工具 。gb 意识 到 ， 不 一 定 要 包装 Go 本 身 的 工具 ， 
也 可 以 使 用 其 他 方法 来 解决 可 重复 构建 的 问题 。 

gb 背后 的 原理 源 自理 解 到 Go 语言 的 import 语句 并 没有 提供 可 重复 构建 的 能 力 。import 
语句 可 以 驱动 go get ， 但 是 import 本 身 并 没有 包含 足够 的 信息 来 决定 到 底 要 获取 包 的 哪个 修 
改 的 版 本 。go get 无 法 定位 待 获取 代码 的 问题 ， 导 致 Go 工具 在 解决 重复 构建 时 ， 不 得 不 使 用 
复杂 且 难 看 的 方法 。 我 们 已 经 看 到 过 使 用 godep 时 超 长 的 导入 路 径 是 多 么 难看 。 

gb 的 创建 源 于 上 述 理解 。gb 既 不 包装 Go 工具 链 , 也 不 使 用 GOPATH。gb 基于 工程 将 Go 工 
具 链 工作 空间 的 元 信息 做 替换 。 这 种 依赖 管理 的 方法 不 需要 重 写 工 程 内 代码 的 导 人 和 人 路径。 而且 导 
入 路 径 依旧 通过 go get 和 GOPATH 工作 空间 来 管理 。 

让 我 们 看 看 上 一 节 的 工程 如 何 转换 为 gb 工程 ， 如 代码 清单 3-12 所 示 。 


代码 清单 3-12 ”gb 工程 的 例子 


/home/bill/devel/myproject ($PROJECT) 
|-- Ste 











| |-- cmd 
| | |-- myproject 
| | | |-- main.go 
| |-- examples 
| |-- model 
| |-- README .md 
|-- vendor 
|-- src 
|-- bitbucket .org 
| | ww 
| |-- goautoneg 
| |-- Makefile 
| |-- README .txt 
| |-- autoneg.go 
| |-- autoneg test.go 
|-- github.com 
|-- beorn7 
|-- perks 
|-- README .md 
|-- quantile 
|-- bench test .go 
|-- example test.go 
|-- exampledata.txt 
|-- stream.go 


一 个 gb 工程 就 是 磁盘 上 一 个 包含 src/ 子 目录 的 目录 。 符 号 SPROJECT 导 和 人 了 工程 的 根 目 
录 中 ， 其 下 有 一 个 src/ 的 子 目录 中 。 这 个 符号 只 是 一 个 简写 ， 用 来 描述 工程 在 磁盘 上 的 位 置 。 
$PROJECT 不 是 必须 设置 的 环境 变量 。 事 实 上 ，gb 根本 不 需要 设置 任何 环境 变量 。 

gb 工程 会 区 分 开发 人 员 写 的 代码 和 开发 人 员 需 要 依赖 的 代码 。 开 发 人 员 的 代码 所 依赖 的 代 
码 被 称 作 第 三 方 代码 ( vendored code )。gb 工程 会 明确 区 分 开发 人 员 的 代码 和 第 三 方 代 码 ， 如 代 
码 清 单 3-13 和 代码 清单 3-14 所 示 。 





代码 清单 3-13 ”工程 中 存放 开发 人 员 写 的 代码 的 位 置 


$PROJECT/src/ 





代码 清单 3-14 ”存放 第 三 方 代码 的 位 置 
$PROJECT/vendor/src/ 


邑 一 个 最 好 的 特点 是 ， 不 需要 重 写 导 入 路 径 。 可 以 看 看 这 个 工程 里 的 main.go 文件 的 import 





语句 一 一 没有 任何 需要 为 导 和 第 三 方 库 而 做 的 修改 ， 如 代码 清单 3-15 所 示 。 


代码 清单 3-15 ”gb 工程 的 导入 路 径 


01 Package main 


02 

03 import ( 

04 "bitbucket .org/ww/goautoneg" 
05 "github.com/beorn7/perks" 





gb 工具 首先 会 在 SPROJECT/src/ 目 录 中 查找 代码 , 如 果 找 不 到 , 会 在 SPROJECT/vender/src/ 
目录 里 查找 。 与 工程 相关 的 整个 源 代码 都 会 在 同一 个 代码 库 里 。 自 己 写 的 代码 在 工程 目录 的 src/ 
目录 中 ， 第 三 方 依赖 代码 在 工程 目录 的 vender/src 子 目 录 中 。 这 样 ， 不 需要 配合 重 写 导 人 路 
径 也 可 以 完成 整个 构建 过 程 ， 同 时 可 以 把 整个 工程 放 到 磁盘 的 任意 位 置 。 这 些 特点 ， 让 gb 成 为 
社区 里 解决 可 重复 构建 的 流行 工具 。 

还 需要 提 一 点 : gb 工程 与 Go 官方 工具 链 (包括 go get ) 并 不 兼容 。 因 为 gb 不 需要 设置 
GOPATH， 而 Go 工具 链 无 法 理解 gb 工程 的 目录 结构 ， 所 以 无 法 用 Go 工具 链 构 建 、 测 试 或 者 获 
取代 码 。 构 建 ( 如 代码 清单 3-16 所 示 ) 和 测试 gb 工程 需要 先进 入 $PROJECT 目录 ,并 使 用 gb 
工具 


一 一 一 、 人 O 


gb build all 

很 多 Go 工具 支持 的 特性 ，gb 都 提供 对 应 的 特性 。gb 还 提供 了 插件 系统 ， 可 以 让 社区 扩展 
支持 的 功能 。 其 中 一 个 插件 叫 作 vender。 这 个 插件 可 以 方便 地 管理 $4PROJECT/vender/src/ 
目录 里 的 依赖 关系 ， 而 这 个 功能 Go 工具 链 至 今 没有 提供 。 想 了 解 更 多 gb 的 特性 ， 可 以 访问 这 
个 网 站 : getgb.io。 




































































VX% 小 结 


在 Go 语言 中 包 是 组 织 代 码 的 基本 单位 。 

环境 变量 GOPATH 决定 了 Go 源 代码 在 磁盘 上 被 保存 、 编 译 和 安装 的 位 置 。 

可 以 为 每 个 工程 设置 不 同 的 GOPATH， 以 保持 源 代码 和 依赖 的 隔离 。 

go 工具 是 在 命令 行 上 工作 的 最 好 工具 。 

开发 人 员 可 以 使 用 go get 来 获取 别人 的 包 并 将 其 安装 到 自己 的 GOPATH 指定 的 目录 。 
想 要 为 别人 创建 包 很 简单 , 只 要 把 源 代码 放 到 公用 代码 库 , 并 遵守 一 些 简单 规则 就 可 以 了 。 
Go 语言 在 设计 时 将 分 享 代码 作为 语言 的 核心 特性 和 驱动 力 。 

推荐 使 用 依赖 管理 工具 来 管理 依赖 。 

有 很 多 社区 开发 的 依赖 管理 工具 ， 如 godep 、vender 和 gb。 
































第 4 蔓 数组 、 切 片 和 映射 





本 章 主要 内 容 

图 ”数组 的 内 部 实现 和 基础 功能 
四 ”使 用 切片 管理 数据 集合 

国 ”使 用 映射 管理 键 值 对 


很 难 遇 到 要 编写 一 个 不 需要 存储 和 读 取 集合 数据 的 程序 的 情况 。 如 果 使 用 数据 库 或 者 文件 ， 
或 者 访问 网 络 ， 总 需要 一 种 方法 来 处 理 接收 和 发 送 的 数据 。Go 语言 有 3 种 数据 结构 可 以 让 用 户 
管理 集合 数据 : 数组 、 切 片 和 映射 。 这 3 种 数据 结构 是 语言 核心 的 一 部 分 ,在 标准 库 里 被 广泛 使 
用 。 一 旦 学 会 如 何 使 用 这 些 数据 结构 ， 用 Go 语言 编写 程序 会 变 得 快速 、 有 趣 且 十 分 灵活 。 





















































wse 数组 的 内 部 实现 和 基础 功能 


了 解 这 些 数据 结构 , 一般 会 从 数组 开始 ,因为 数组 是 切片 和 映射 的 基础 数据 结构 。 理 解 了 数 
组 的 工作 原理 ， 有 助 于 理解 切片 和 映射 提供 的 优雅 和 强大 的 功能 。 











4.1.1 内 部 实现 


在 Go 语言 里 ， 数 组 是 一 个 长 度 固定 的 数据 类 型 ， 用 于 存储 一 段 具有 相同 的 类 型 的 元 素 的 连 
续 块 。 数 组 存储 的 类 型 可 以 是 内 置 类 型 ， 如 整 型 或 者 字符 串 ， 也 可 以 是 某 种 结构 类 型 。 

在 图 4-1 中 可 以 看 到 数组 的 表示 。 灰色 格子 代表 数组 里 的 元 素 , 每 个 元 素 都 紧邻 男 一 个 元 素 。 
每 个 元 素 包含 相同 的 类 型 ， 这 个 例子 里 是 整数 ,并且 每 个 元 素 可 以 用 一 个 唯一 的 索引 (也 称 下 标 
或 标号 ) 来 访问 。 

数组 是 一 种 非常 有 用 的 数据 结构 ， 因 为 其 占用 的 内 存 是 连续 分 配 的 。 由 于 内 存 连续 ，CPU 
能 把 正在 使 用 的 数据 缓存 更 久 的 时 间 。 而 且 内 存 连续 很 容易 计算 索引 , 可 以 快速 迭代 数组 里 的 所 
有 元 素 。 数组 的 类 型 信息 可 以 提供 每 次 访问 一 个 元 素 时 需要 在 内 存 中 移动 的 距离 。 既 然 数 组 的 每 
个 元 素 类 型 相同 ， 又 是 连续 分 配 ， 就 可 以 以 固定 速度 索引 数组 中 的 任意 数据 ， 速 度 非常 快 。 












































































































































图 4-1 数组 的 内 部 实现 





4.1.2 ”声明 和 初始 化 


声明 数组 时 需要 指定 内 部 存储 的 数据 的 类 型 ,以 及 需要 存储 的 元 素 的 数量 , 这 个 数量 也 称 为 
数组 的 长 度 ， 如 代码 清单 4-1 所 示 。 





代码 清单 4-1 声明 一 个 数组 ， 并 设置 为 零 值 

// 声明 一 个 包含 5 个 元 素 的 整 型 数组 

Var array [5]int 

一 旦 声明 ， 数 组 里 存储 的 数据 类 型 和 数组 长 度 就 都 不 能 改变 了 。 如 果 需 要 存储 更 多 的 元 素 ， 
就 需要 先 创建 一 个 更 长 的 数组 ， 再 把 原来 数组 里 的 值 复制 到 新 数组 里 。 

在 Go 语言 中 声明 变量 时 ， 总 会 使 用 对 应 类 型 的 零 值 来 对 变量 进行 初始 化 。 数 组 也 不 例外 。 
当 数组 初始 化 时 ， 数 组 内 每 个 元 素 都 初始 化 为 对 应 类 型 的 零 值 。 在 图 4-2 里 ， 可 以 看 到 整 型 数组 
里 的 每 个 元 素 都 初始 化 为 0， 也 就 是 整 型 的 零 值 。 





图 4-2 ”声明 数组 变量 后 数组 的 值 








一 种 快速 创建 数组 并 初始 化 的 方式 是 使 用 数组 字面 量 。 数 组 字面 量 允 许 声 明 数 组 里 元 素 的 数 
量 同时 指定 每 个 元 素 的 值 ， 如 代码 清单 4-2 所 示 。 





代码 清单 4-2 ”使 用 数组 字面 量 声明 数组 


// 声明 一 个 包含 5 个 元 素 的 整 型 数组 
// 用 具体 值 初始 化 每 个 元 素 
array := [5]int{10, 20, 30, 40, 50} 


如 果 使 用 . . .替代 数组 的 长 度 ，Go 语言 会 根据 初始 化 时 数组 元 素 的 数量 来 确定 该 数组 的 长 
如 代码 清单 4-3 所 示 。 





学 





代码 清单 4-3 让 Go 自动 计算 声明 数组 的 长 度 


// 声明 一 个 整 型 数组 
// 用 具体 值 初始 化 每 个 元 素 





// 容量 由 初始 化 值 的 数量 决定 
array te [ss Jinttl0r 207 307% 40; 50} 


如 果 知 道 数组 的 长 度 而 是 准备 给 每 个 值 都 指定 具体 值 , 就 可 以 使 用 代码 清单 4-4 所 示 的 这 种 
语法 。 








代码 清单 4-4 声明 数组 并 指定 特定 元 素 的 值 


// 声明 一 个 有 5 个 元 素 的 数组 

// 用 具体 值 初始 化 索引 为 1 和 2 的 元 素 
// 其 余 元 素 保 持 零 值 

array := [5]int{1: 10, 2: 20} 


代码 清单 4-4 中 声明 的 数组 在 声明 和 初始 化 后 ， 会 和 图 4-3 所 展现 的 一 样 。 


[ed | 
[ed | 


图 4-3 ”声明 之 后 数组 的 值 



































4.1.3 ”使 用 数组 


正 像 之 前 提 到 的 ， 因为 内 存 布 局 是 连续 的 ， 所 以 数组 是 效率 很 高 的 数据 结构 。 在 访问 数组 里 
任意 元 素 的 时 候 ， 这 种 高 效 都 是 数组 的 优势 。 要 访问 数组 里 某 个 单独 元 素 ， 使 用 [] 运算 符 ， 如 
代码 清单 4-5 所 示 。 


代码 清单 4-5 ”访问 数组 元 素 


// 声明 一 个 包含 5 个 元 素 的 整 型 数组 
// 用 具体 值 初始 为 每 个 元 素 
array := [5]int{10, 20, 30, 40, 50} 








// 修改 索引 为 2 的 元 素 的 值 
array[2] = 35 


代码 清单 4-5 中 声明 的 数组 的 值 在 操作 完成 后 ,会 和 图 4-4 所 展现 的 一 样 。 


a 
a 


图 4-4 修改 索引 为 2 的 值 之 后 数组 的 值 


可 以 像 第 2 章 一 样 ， 声 明 一 个 所 有 元 素 都 是 指针 的 数组 。 使 用 * 运 算 符 就 可 以 访问 元 素 指针 
所 指向 的 值 ， 如 代码 清单 4-6 所 示 。 

















代码 清单 4-6 ”访问 指针 数组 的 元 素 
// 声明 包含 5 个 元 素 的 指向 整数 的 数组 
// 用 整 型 指针 初始 化 索引 为 0 和 1 的 数组 元 素 
array := [5]*int{0: new(int), 1: new(int) } 


// 为 索引 为 0 和 1 的 元 素 赋值 


10 
20 


*array[0] 
*array[1] 


代码 清单 4-6 中 声明 的 数组 的 值 在 操作 完 


毕 


， 会 和 图 4-5 所 展现 的 一 样 。 








在 Go 语言 


， 数 组 是 一 个 值 。 


[3] [4] 
地 址 地 址 
指向 整 型 的 指针 || 指向 整 型 的 指针 


4-5 ”指向 整数 的 指针 数组 
这 意味 着 数组 可 以 用 在 赋值 操作 中 。” 


图 





变量 名 代表 整个 数组 ， 


因此 ， 同样 类 型 的 数组 可 以 赋值 给 另 一 个 数组 ， 如 代码 清单 4-7 所 示 。 


代码 清单 4-7 ”把 同样 类 型 的 一 


个 数组 赋值 给 另外 一 个 数组 



































// 声明 第 一 个 包含 5 个 元 素 的 字符 串 数组 
Var arrayl [5]string 
// 声明 第 二 个 包含 5 个 元 素 的 字符 串 数组 
// 用 颜色 初始 化 数组 
array2 := [5]string{"Red", "Blue", "Green", "Yellow", "Pink"} 
// 把 array2 的 值 复制 到 array1 
arrayl = array2 
复制 之 后 ， 两 个 数组 的 值 完全 一 样 ， 如 图 4-6 所 示 。 
[0] [1] [4] 
甘于 Be | | 时 | 
甘于 Be | | 时 | 
[0] [1] 本 [3] [4] 
Red Blue Green Yellow Pink 
字符 串 字符 串 字符 串 字符 串 字符 串 





图 4-6 复制 之 后 的 两 个 数组 
型 包括 数组 长 度 和 每 个 元 素 的 类 型 。 只 有 这 两 部 分 都 相同 的 数组 , 才 是 类 型 相 





数组 变量 的 类 


同 的 数组 ， 才 能 互相 赋值 ， 如 代码 清单 4-8 所 示 。 





代码 清单 4-8 ”编译 器 会 阻止 类 型 不 同 的 数组 互相 赋值 
// 声明 第 一 个 包含 4 个 元 素 的 字符 串 数 组 





Var arrayl [4]string 

















// 声明 第 二 个 包含 5 个 元 素 的 字符 串 数 组 
// 使 用 颜色 初始 化 数组 


array2 := [5]string{"Red", "Blue", "Green", "Yellow", "Pink"} 








// 将 array2 复制 给 arrayl 
arrayl = array2 


Compiler Error: 
cannot use array2 (type [5]string) as type [4]string in assignment 


复制 数组 指针 ， 只 会 复制 指针 的 值 ， 而 不 会 复制 指针 所 指向 的 值 ， 如 代码 清单 4-9 所 示 。 





代码 清单 4-9 ”把 一 个 指针 数组 赋值 给 另 一 个 
// 声明 第 一 个 包含 3 个 元 素 的 指向 字符 串 的 指针 数组 














Var arrayl [3]*string 





























// 声明 第 二 个 包含 3 个 元 素 的 指向 字符 串 的 指针 数组 
// 使 用 字符 串 指 针 初 始 化 这 个 数组 


[3]*xstzingfnew(string9)，new(string)，new(string) } 














array2 : 














// 使 用 颜色 为 每 个 元 素 赋值 


SS 


*array2[0] = "Red" 
*array2[1] = "Blue" 
*array2[2] = "Green" 


// 将 array2 复制 给 arrayl 
arrayl = array2 


复制 之 后 ， 两 个 数组 指向 同一 组 字符 串 ， 如 图 4-7 所 示 。 


[0] 
指向 字符 串 的 指针 





[1] [2] 


地 址 地 址 
指向 字符 串 的 指针 | 指向 字符 串 的 指针 










地 址 地 址 地 址 
指向 字符 审 的 指针 | 指向 字符 串 的 指针 | 指向 字符 串 的 指针 


[0] [1] [2] 
4-7 ”两 组 指向 同样 字符 串 的 数组 





低 





4.1.4 多维 数 组 


数组 本 身 只 有 一 个 维度 , 不 过 可 以 组 合 多 个 数组 创建 多 维 数组 。 多 维 数组 很 容易 管理 具有 父 
子 关系 的 数据 或 者 与 坐标 系 相关 联 的 数据 。 声 明 二 维 数组 的 示例 如 代码 清单 4-10 所 示 。 


代码 清单 4-10 ”声明 二 维 数 组 
// 声明 一 个 二 维 整 型 数组 ， 两 个 维度 分 别 存储 4 个 元 素 和 2 个 元 素 


var array [4] [2]int 




















// 使 用 数组 字面 量 来 声明 并 初始 化 一 个 二 维 整 型 数组 
avray = [4] 12]inE(t(10, TT}, {20, 21}, 130; 31}, C40, 41}) 











// 声明 并 初始 化 外 层 数组 中 索引 为 1 个 和 3 的 元 素 
array := [4] [2]int{1: {20, 21}, 3: {40, 41}} 

















// 声明 并 初始 化 外 层 数组 和 内 层 数组 的 单个 元 素 
array := [4] [2]int{1: {0: 20}, 3: {1: 41}} 


图 4-8 展示 了 代码 清单 4-10 中 声明 的 二 维 数组 在 每 次 声明 并 初始 化 后 包含 的 值 。 











[0] [1] [2] [3] 
Qo (30 | an 
整 型 数组 整 型 数组 整 型 数组 整 型 数组 

array := [4] [2]int{{10, 11}, {20, 21}, {30, 31}, {40, 41})} 


[0] 失重 | [2] [3] 


Loj oj 


整 型 数组 整 型 数组 整 型 数组 
array := [4] [2]intf1l: {20, 21}, 3: {40, 41}} 


[0] [1] [2] [3] 


Loj oj Lo io | Lo Un 


整 型 数组 整 型 数组 整 型 数组 整 型 数组 
array := [4] [2]int{1l: {0: 20}, 3: {1: 41}} 

















图 4-8 ”二 维 数组 及 其 外 层 数组 和 内 层 数组 的 值 
为 了 访问 单个 元 素 ， 需 要 反复 组 合 使 用 [] 运算 符 ， 如 代码 清单 4-11 所 示 。 


代码 清单 4-11 访问 二 维 数组 的 元 素 





// 声明 一 个 2X2 的 二 维 整 型 数组 


var array [2] [2]int 





// 设置 每 个 元 素 的 整 型 值 
array[0][0] = 10 


array[0] [1] = 20 
array[1][0] = 30 
array[1][1] = 40 


只 要 类 型 一 致 ， 就 可 以 将 多 维 数组 互相 赋值 ， 如 代码 清单 4-12 所 示 。 多 维 数组 的 类 型 包括 每 
一 维度 的 长 度 以 及 最 终 存储 在 元 素 中 的 数据 的 类 型 。 





代码 清单 4-12 ”同样 类 型 的 多 维 数组 赋值 


// 声明 两 个 不 同 的 二 维 整 型 数组 
var arrayl [2] [2]int 
var array2 [2] [2]int 


// 为 每 个 元 素 赋值 


array2[0][0] = 10 
array2[0][1] = 20 
array2 [1][0] = 30 
array2 [1][1] = 40 


// 将 array2 的 值 复制 给 arrayl 


arrayl = array2 


因为 每 个 数组 都 是 一 个 值 ， 所 以 可 以 独立 复制 某 个 维度 ， 如 代码 清单 4-13 所 示 。 





代码 清单 4-13 ”使 用 索引 为 多 维 数组 赋值 





// 将 array1 的 索引 为 1 的 维度 复制 到 一 个 同类 型 的 新 数组 里 


Var array3 [2]int = arrayll[1] 








// 将 外 层 数组 的 索引 为 1、 内 层 数 组 的 索引 为 0 的 整 型 值 复制 到 新 的 整 型 变量 里 


Var Value int = arrayl[1] [0] 


4.1.5 在 函数 间 传 递 数组 


根据 内 存 和 性 能 来 看 ， 在 函数 间 传 递 数组 是 一 个 开销 很 大 的 操作 。 在 函数 之 间 传 递 变量 时 ， 
总 是 以 值 的 方式 传递 的 。 如 果 这 个 变量 是 一 个 数组 ,意味 着 整个 数组 ,不管 有 多 长 ， 都 会 完整 复 
制 ， 并 传递 给 函数 。 

为 了 考察 这 个 操作 ， 我 们 来 创建 一 个 包含 100 万 个 int 类 型 元 素 的 数组 。 在 64 位 架构 上 ， 
这 将 需要 800 万 字 节 ， 即 8 MB 的 内 存 。 如 果 声 明了 这 种 大 小 的 数组 ， 并 将 其 传递 给 函数 ， 会 发 
生 什么 呢 ? 如 代码 清单 4-14 所 示 。 


代码 清单 4-14 ”使 用 值 传递 ， 在 函数 间 传 递 大 数组 


// 声明 一 个 需要 8 MB 的 数组 
var array [1e6]int 





// 将 数组 传递 给 函数 foo 


foo (array) 


// 函数 foo 接受 一 个 100 万 个 整 型 值 的 数组 


func foo(larray [le6]int) { 

; ys 

每 次 函数 foo 被 调用 时 ， 必 须 在 栈 上 分 配 8 MB 的 内 存 。 之 后 ， 整 个 数组 的 值 (8 MB 的 内 
存 ) 被 复制 到 刚 分 配 的 内 存 里 。 虽 然 Go 语言 自己 会 处 理 这 个 复制 操作 ， 不 过 还 有 一 种 更 好 且 更 
有 效 的 方法 来 处 理 这 个 操作 。 可 以 只 传人 指向 数组 的 指针 , 这 样 只 需要 复制 8 字 节 的 数据 而 不 是 
8 MB 的 内 存 数据 到 栈 上 ， 如 代码 清单 4-15 所 示 。 





代码 清单 4-15 ”使 用 指针 在 函数 间 传 递 大 数组 





// 分 配 一 个 需要 8 MB 的 数组 


Var array [le6]int 





// 将 数组 的 地 址 传递 给 函数 foo 


foo (&array) 


// 函数 foo 接受 一 个 指向 100 万 个 整 型 值 的 数组 的 指针 


func foo (array *[le6]int) { 


} 

这 次 函数 foo 接受 一 个 指向 100 万 个 整 型 值 的 数组 的 指针 。 现 在 将 数组 的 地 址 传 入 函数 ， 
只 需要 在 栈 上 分 配 8 字 节 的 内 存 给 指针 就 可 以 。 

这 个 操作 会 更 有 效 地 利用 内 存 ， 性 能 也 更 好 。 不 过 要 意识 到 ， 因 为 现在 传递 的 是 指针 ， 
所 以 如 果 改 变 指 针 指 向 的 值 ， 会 改变 共享 的 内 存 。 如 你 所 见 ， 使 用 切片 能 更 好 地 处 理 这 类 共 


享 问题 。 


























ws 切片 的 内 部 实现 和 基础 功能 


切片 是 一 种 数据 结构 ,这 种 数据 结构 便于 使 用 和 管理 数据 集合 。 切片 是 围绕 动态 数组 的 概念 
构建 的 , 可 以 按 需 自动 增长 和 缩小 。 切片 的 动态 增长 是 通过 内 置 函 数 appenq 来 实现 的 。 这 个 矣 
数 可 以 快速 且 高 效 地 增长 切片 。 还 可 以 通过 对 切片 再 次 切片 来 缩小 一 个 切片 的 大 小 。 因 为 切片 的 
底层 内 存 也 是 在 连续 块 中 分 配 的 ， 所 以 切片 还 能 获得 索引 、 和 迭代 以 及 为 垃圾 回收 优化 的 好 处 。 

















4.2.1 内 部 实现 


切片 是 一 个 很 小 的 对 象 ， 对 底层 数组 进行 了 抽象 ,并 提供 相关 的 操作 方法 。 切 片 有 3 个 字段 
的 数据 结构 ， 这 些 数据 结构 包含 Go 语言 需要 操作 底层 数组 的 元 数据 ( 见 图 4-9 )。 

这 3 个 字段 分 别 是 指向 底层 数组 的 指针 、 切 片 访 问 的 元 素 的 个 数 ( 即 长 度 ) 和 切片 允许 增长 
到 的 元 素 个 数 ( 即 容 量 )。 后 面 会 进一步 讲解 长 度 和 容量 的 区 别 。 








整 型 切片 : 
3 长 度 为 3 个 整 型 值 
长 度 容量 为 5 个 整 型 值 











图 4-9 切片 内 部 实现 : 底层 数组 


4.2.2 ”创建 和 初始 化 


o 语言 中 有 几 种 方法 可 以 创建 和 初始 化 切片 。 是 否 能 提前 知道 切片 需要 的 容量 通常 会 决定 
| 片 。 


1. make 和 切片 字面 量 


一 种 创建 切片 的 方法 是 使 用 内 置 的 make 函数 。 当 使 用 make 时 ， 需 要 传人 一 个 参数 ， 指 定 
切片 的 长 度 ， 如 代码 清单 4-16 所 示 。 


; 


代码 清单 4-16 ”使 用 长 度 声明 一 个 字符 串 切 片 
// 创建 一 个 字符 串 切片 
// 其 长 度 和 容量 都 是 5 个 元 素 
slice := make([]string 5) 
如 果 只 指定 长 度 ， 那 么 切片 的 容量 和 长 度 相等 。 也 可 以 分 别 指定 长 度 和 容量 ， 如 代码 清单 4-17 
所 示 。 


// 创建 一 个 整 型 切片 

// 其 长 度 为 3 个 元 素 ， 容 量 为 5 个 元 素 

slice := make ([]int, 3, 5) 

分 别 指定 长 度 和 容量 时 , 创建 的 切片 , 底层 数组 的 长 度 是 指定 的 容量 , 但 是 初始 化 后 并 不 能 
访问 所 有 的 数组 元 素 。 图 4-9 描述 了 代码 清单 4-17 里 声明 的 整 型 切片 在 初始 化 并 存 人 一 些 值 后 的 
样子 。 

代码 清单 4-17 中 的 切片 可 以 访问 3 个 元 素 ， 而 底层 数组 拥有 5 个 元 素 。 剩 余 的 2 个 元 素 可 
以 在 后 期 操作 中 合并 到 切片 ,可 以 通过 切片 访问 这 些 元 素 。 如 果 基 于 这 个 切片 创建 新 的 切片 ， 新 
切片 会 和 原 有 切片 共享 底层 数组 ， 也 能 通过 后 期 操作 来 访问 多 余 容 量 的 元 素 。 

不 允许 创建 容量 小 于 长 度 的 切片 ， 如 代码 清单 4-18 所 示 。 



































代码 清单 4-18 ”容量 小 于 长 度 的 切片 会 在 编译 时 报错 








// 创建 一 个 整 型 切片 
// 使 其 长 度 大 于 容量 


slice := make([]int, 5, 3) 





Compiler Error: 
len larger than cap in make([]int) 


男 一 种 常用 的 创建 切片 的 方法 是 使 用 切片 字面 量 ， 如 代码 清单 4-19 所 示 。 这 种 方法 和 创建 
数组 类 似 ， 只 是 不 需要 指定 [] 运算 符 里 的 值 。 初 始 的 长 度 和 容量 会 基于 初始 化 时 提供 的 元 素 的 
个 数 确定 。 





代码 清单 4-19 ”通过 切片 字面 量 来 声明 切片 











// 创建 字符 串 切 片 
// 其 长 度 和 容量 都 是 5 个 元 素 
slice := []string{"Red", "Blue", "Green", "Yellow", "Pink"} 

















// 创建 一 个 整 型 切片 

// 其 长 度 和 容量 都 是 3 个 元 素 

slice := []int{10, 20, 30} 

当 使 用 切片 字面 量 时 ， 可 以 设置 初始 长 度 和 容量 。 要 做 的 就 是 在 初始 化 时 给 出 所 需 的 长 
度 和 容量 作为 索引 。 代 码 清 单 4-20 中 的 语法 展示 了 如 何 创建 长 度 和 容量 都 是 100 个 元 素 的 
切片 。 


代码 清单 4-20 ”使 用 索引 声明 切片 
// 创建 字符 串 切 片 
// 使 用 空 字符 串 初始 化 第 100 个 元 素 
sliece se]sttingl99:. 93 
记 住 ， 如 果 在 [] 运算 符 里 指定 了 一 个 值 ， 那 么 创建 的 就 是 数组 而 不 是 切片 。 只 有 不 指定 值 
的 时 候 ， 才 会 创建 切片 ， 如 代码 清单 4-21 所 示 。 

































































代码 清单 4-21 声明 数组 和 声明 切片 的 不 同 





// 创建 有 3 个 元 素 的 整 型 数组 
array := [3]int{10, 20, 30} 





// 创建 长 度 和 容量 都 是 3 的 整 型 切片 
slice := []int{10, 20, 30} 


2. nil 和 空 切片 








有 时 ,程序 可 能 需要 声明 一 个 值 为 nil 的 切片 (也 称 nil 切片 )。 只 要 在 声明 时 不 做 任何 初 


始 化 ， 就 会 创建 一 个 nil 切片， 如 代码 清单 4-22 所 示 。 


代码 清单 4-22 ”创建 nil 切片 


// 创建 nil 整 型 切片 


Var slice []int 


在 Go 语言 里 ，nil 切片 是 很 常见 的 创建 切片 的 方法 。nil 切片 可 以 用 于 很 多 标准 库 和 内 置 
函数 。 在 需要 描述 一 个 不 存在 的 切片 时 , nil 切片 会 很 好 用 。 例 如， 函数 要 求 返 回 一 个 切片 但 是 
发 生 异 常 的 时 候 ( 见 图 4-10 )。 


| nil 切 片 : 
nil 0 0 长 度 为 0 
指针 长 度 容量 容量 为 0 


var slice []int 








图 4-10 nil 切片 的 表示 


利用 初始 化 ， 通 过 声明 一 个 切片 可 以 创建 一 个 空 切 片 ， 如 代码 清单 4-23 所 示 。 


代码 清单 4-23 ”声明 空 切片 


// 使 用 make 创建 空 的 整 型 切片 


slice := make([]int, 0) 






































// 使 用 切片 字面 量 创建 空 的 整 型 切片 


slice := []int{} 


空 切片 在 底层 数组 包含 0 个 元 素 ， 也 没有 分 配 任何 存储 空间 。 想 表示 空 集合 时 空 切片 很 有 用 ， 
例如 ， 数 据 库 查询 返回 0 个 查询 结果 时 ( 见 图 4-11 )。 














地 址 0 | 
指针 上 长度 | 


slice := make([]int, 0) 
slice := [J]int{} 





图 4-11 ” 空 切 片 的 表示 





管 是 使 用 nil 切片 还 是 空 切片 ， 对 其 调用 内 置 函 数 append、len 和 cap 的 效果 都 是 


4.2.3 ”使 用 切片 
现在 知道 了 什么 是 切片 ， 也 知道 如 何 创 建 切片 ， 来 看 看 如 何在 程序 里 使 用 切片 。 


1， 赋 值 和 切片 


对 切片 里 某 个 索引 指向 的 元 素 赋值 和 对 数组 里 某 个 索引 指向 的 元 素 赋值 的 方法 完全 一 样 。 使 
用 [操作 符 就 可 以 改变 某 个 元 素 的 值 ， 如 代码 清单 4-24 所 示 。 


代码 清单 4-24 ”使 用 切片 字面 量 来 声明 切 卢 


// 创建 一 个 整 型 切片 
// 其 容量 和 长 度 都 是 5 个 元 素 
slice := []int{10，20，30，40，50} 























// 改变 索引 为 1 的 元 素 的 值 
slice[1] = 25 


切片 之 所 以 被 称 为 切片 ， 是 因为 创建 一 个 新 的 切片 就 是 把 底层 数组 切 出 一 部 分 ， 如 代码 清 
单 4-25 所 示 。 


代码 清单 4-25 ”使 用 切片 创建 切片 


// 创建 一 个 整 型 切片 
// 其 长 度 和 容量 都 是 5 个 元 素 
slice := []int{10，20，30，40，50} 






































// 创建 一 个 新 切片 
// 其 长 度 为 2 个 元 素 ， 容 量 为 4 个 元 素 
newSlice := slice[1:3] 


执行 完 代码 清单 4-25 中 的 切片 动作 后 ， 我 们 有 了 两 个 切片 ， 它 们 共享 同一 段 底层 数组 ， 但 
通过 不 同 的 切片 会 看 到 底层 数组 的 不 同 部 分 ( 见 图 4-12 )。 

















slice := []int{10, 20, 30, 40, 50} 


地 址 5 5 
指针 长 度 容量 

[0] [1] [2] [3] [4] 
[0] [1] [2] [3] 
地 址 2 4 
指针 长 度 容量 


newSlice := slice[l1:3] 





图 4-12 ”共享 同一 底层 数组 的 两 个 切片 





第 一 个 切片 slice 能 够 看 到 底层 数组 全 部 5 个 元 素 的 容量 , 不 过 之 后 的 newSlice 就 看 不 
到 。 对 于 newSlice， 底 层 数组 的 容量 只 有 4 个 元 素 。newS1ice 无 法 访问 到 它 所 指向 的 底层 数 
组 的 第 一 个 元 素 之 前 的 部 分 。 所 以 ,对 newSlice 来 说 ， 之 前 的 那些 元 素 就 是 不 存在 的 。 

使 用 代码 清单 4-26 所 示 的 公式 ， 可 以 计算 出 任意 切片 的 长 度 和 容量 。 























代码 清单 4-26 ”如 何 计算 长 度 和 容量 


对 底层 数组 容量 是 k 的 切片 slice[i:j] 来 说 





长 度 : Jj 


容量 : k - 


对 newSlice 应 用 这 个 公式 就 能 得 到 代码 清单 4-27 所 示 的 数字 。 





代码 清单 4-27 计算 新 的 长 度 和 容量 


对 底层 数组 容量 是 5 的 切片 slice[1:3] 来 说 





长 度 : 3 - 1 

容量 : 5 - 1 

可 以 用 为 一 种 方法 来 描述 这 几 个 值 。 第 一 个 值 表示 新 切片 开始 的 元 素 的 索引 位 置 , 这 个 例子 
中 是 1。 第 二 个 值 表示 开始 的 索引 位 置 (1)， 加 上 希望 包含 的 元 素 的 个 数 (2 )，1+2 的 结果 是 3， 
所 以 第 二 个 值 就 是 3。 容量 是 该 与 切片 相关 联 的 所 有 元 素 的 数量 。 

需要 记 住 的 是 , 现在 两 个 切片 共享 同一 个 底层 数组 。 如 果 一 个 切片 修改 了 该 底层 数组 的 共享 
部 分 ， 另 一 个 切片 也 能 感知 到 ， 如 代码 清单 4-28 所 示 。 


2 
4 











代码 清单 4-28 ”修改 切片 内 容 可 能 导致 的 结果 
// 创建 一 个 整 型 切片 























// 其 长 度 和 容量 都 是 5 个 元 素 
slice := []int{10, 20, 30, 40, 50} 





// 创建 一 个 新 切片 
// 其 长 度 是 2 个 元 素 ， 容 量 是 4 个 元 素 
newSlice := slice[1:3] 























// 修改 newSlice 索引 为 1 的 元 素 

// 同时 也 修改 了 原来 的 slice 的 索引 为 2 的 元 素 

newSlice[1] = 35 

把 35 赋值 给 newSlice 的 第 二 个 元 素 (索引 为 1 的 元 素 ) 的 同时 也 是 在 修改 原来 的 slice 
的 第 3 个 元 素 ( 索引 为 2 的 元 素 ) ( 见 图 4-13 )。 

切片 只 能 访问 到 其 长 度 内 的 元 素 。 试图 访问 超出 其 长 度 的 元 素 将 会 导致 语言 运行 时 异 第 ,如 
代码 清单 4-29 所 示 。 与 切片 的 容量 相关 联 的 元 素 只 能 用 于 增长 切片 。 在 使 用 这 部 分 元 素 前 ， 必 须 
将 其 合并 到 切片 的 长 度 里 。 

















slice := []int{10, 20, 30, 40, 50} 

地 址 5 

指针 容量 
[0] [1] [2] [3] [4] 

[= |» [| «| = | 

[0] [1] [2] [3] 
地 址 2 4 对 newSlice 执 行 赋值 操作 之 后 
指针 长 度 容量 newSlice[1] = 35 

newSlice := slice[1:3] 





图 4-13 ”赋值 操作 之 后 的 底层 数组 





// 创建 一 个 整 型 切片 


// 创建 一 个 新 切片 




















A 长 








度 和 容量 都 是 5 个 元 素 


:= [lint{Ll07 20. 30r “40 :503 























// 其 长 度 为 2 个 元 素 ， 容 量 为 4 个 元 素 
newSlice := slice[1:3] 





// 修改 newSlice 索引 为 3 的 元 素 


// 这 个 元 素 对 于 newSlice 来 说 并 不 存在 











newSlice[3] = 45 


Runtime Exception: 


panic: 


切片 有 额外 的 容量 是 很 好 , 但 是 如 果 不 能 把 这 些 容量 合并 到 切片 的 长 度 里 , 这 些 容量 就 没有 
用 处 。 好 在 可 以 用 Go 语言 的 内 置 函 数 append 来 做 这 种 合 


runtime error: index out of range 


种 合并 很 容易 。 


2. 切片 增长 


相对 于 数组 而 言 , 使 用 切片 的 一 个 好 处 是 , 可 以 按 需 增加 切片 的 容量 。 Go 语言 内 置 的 append 


函数 会 处 理 增 加 长 度 时 的 所 有 操作 细节 。 


要 使 用 apPend， 需 要 一 个 被 操作 的 切片 和 一 个 要 追加 的 值 ， 如 代码 清单 4-30 所 示 。 当 
append 调用 返回 时 , 会 返回 一 个 包含 修改 结果 的 新 切片 。 函 数 apPpend 总 是 会 增加 新 切片 的 长 


度 ， 而 容量 有 可 能 会 改变 ， 也 可 能 不 会 改变 ， 这 取决 于 被 操作 的 切片 的 可 用 容量 。 


代码 清单 4-30 ”使 用 append 向 切片 增加 元 素 


// 创建 一 个 整 型 切片 
// 其 长 度 和 容量 都 是 5 个 元 素 
slice := []int{10, 20, 30, 40, 50} 








上 

















// 创建 一 个 新 切片 
// 其 长 度 为 2 个 元 素 ， 容 量 为 4 个 元 素 
newSlice := slice[1:3] 








术 











// 使 用 原 有 的 容量 来 分 配 一 个 新 元 素 
// 将 新 元 素 赋值 为 60 


newSlice = append (newSlice, 60) 


当代 码 清单 4-30 中 的 append 操作 完成 后 ， 两 个 切片 和 底层 数组 的 布局 如 图 4-14 所 示 。 





slice := []int{10, 20, 30, 40, 50} 


TT 
指针 长 度 





newSlice := slice[1:3] newSlice = append (newSlice, 60) 








图 4-14 append 操作 之 后 的 底层 数组 


因为 newSlice 在 底层 数组 里 还 有 额外 的 容量 可 用 ，append 操作 将 可 用 的 元 素 合 并 到 切片 
的 长 度 ， 并 对 其 进行 赋值 。 由 于 和 原始 的 slice 共享 同一 个 底层 数组 ，slice 中 索引 为 3 的 元 
素 的 值 也 被 改动 了 。 

如 果 切 片 的 底层 数组 没有 足够 的 可 用 容量 ，append 函数 会 创建 一 个 新 的 底层 数组 ,将 被 引 
用 的 现 有 的 值 复制 到 新 数组 里 ， 再 追加 新 的 值 ， 如 代码 清单 4-31 所 示 。 





代码 清单 4-31 使 用 append 同时 增加 切片 的 长 度 和 容量 
// 创建 一 个 整 型 切片 


























// 其 长 度 和 容量 都 是 4 个 元 素 
slice := []int{10, 20, 30, 40} 





// 向 切片 追加 一 个 新 元 素 
// 将 新 元 素 赋值 为 50 


newSlice := append(slice, 50) 


当 这 个 append 操作 完成 后 , newSlice 拥有 一 个 全 新 的 底层 数组 , 这 个 数组 的 容量 是 原来 
的 两 倍 ( 见 图 4-15 )。 


slice := []int{10, 20, 30, 40} 


地 址 4 4 
指针 长 度 容量 
[ol 


newSlice := appendl(slice, 50) 








加 这 时 | " 轩 国 罗 


图 4-1 5 ”append 操作 之 后 的 新 的 底层 数组 


函数 appeng 会 智能 地 处 理 底层 数组 的 容量 增长 。 在 切片 的 容量 小 于 1000 个 元 素 时 ， 总 是 
会 成 倍 地 增加 容量 。 一 旦 元 素 个 数 超过 1000, 容量 的 增长 因子 会 设 为 1.25, 也 就 是 会 每 次 增加 25% 
的 容量 。 随 着 语言 的 演化 ， 这 种 增长 算法 可 能 会 有 所 改变 。 


3. 创建 切片 时 的 3 个 索引 


在 创建 切片 时 , 还 可 以 使 用 之 前 我 们 没有 提 及 的 第 三 个 索引 选项 。 第 三 个 索引 可 以 用 来 控制 
新 切片 的 容量 。 其 目的 并 不 是 要 增加 容量 ， 而 是 要 限制 容量 。 可 以 看 到 ， 人 允许 限制 新 切片 的 容量 
为 底层 数组 提供 了 一 定 的 保护 ， 可 以 更 好 地 控制 追加 操作 。 

让 我 们 看 看 一 个 包含 5 个 元 素 的 字符 串 切片 。 这 个 切片 包含 了 本 地 超市 能 找到 的 水 果 名 字 ， 
如 代码 清单 4-32 所 示 。 


代码 清单 4-32 ”使 用 切片 字面 量 声明 一 个 字符 串 切 片 
// 创建 字符 串 切片 
// 其 长 度 和 容量 都 是 5 个 元 素 
source := []string{"Apple", "Orange", "Plum", "Banana", "Grape"} 


如 果 查 看 这 个 包含 水 果 的 切片 的 值 ， 就 像 图 4-16 所 展示 的 样子 。 









































source := []string{"Apple", "Orange", "Plum", "Banana", "Grape"} 
地 址 5 
指针 长 度 


[0] [1] [2] [3] [4] 
[Ce | oe | Pum | Bor | aas | 


图 4-16 ”字符 串 切 片 的 表示 


现在 ， 让 我 们 试 着 用 第 三 个 索引 选项 来 完成 切片 操作 ， 如 代码 清单 4-33 所 示 。 











代码 清单 4-33 ”使 用 3 个 索引 创建 切片 
// 将 第 三 个 元 素 切 片 ， 并 限制 容量 
// 其 长 度 为 1 个 元 素 ， 容 量 为 2 个 元 素 
slice := source[2:3:4] 


这 个 切片 操作 执行 后 ， 新 切片 里 从 底层 数组 引用 了 1 个 元 素 ， 容 量 是 2 个 元 素 。 具 体 来 说 ， 
新 切片 引用 了 Plum 元 素 ， 并 将 容量 扩展 到 Banana 元 素 ， 如 图 4-17 所 示 。 






































Source := []string{"Apple", "Orange", "Plum", "Banana", "Grape"} 


地 址 5 5 

指针 长 度 容量 
[0] [1] [2] [3] [4] 
[0] [1] [2] 


| 
指针 长 度 容量 


slice := source[2:3:4] 








图 4-17 操作 之 后 的 新 切片 的 表示 


我 们 可 以 应 用 之 前 定义 的 公式 来 计算 新 切片 的 长 度 和 容量 ， 如 代码 清单 4-34 所 示 。 


代码 清单 4-34 ”如 何 计算 长 度 和 容量 


对 于 slice[i:j:k] 或 [2:3:4] 


长 度 : j - i 或 3-2 
容量 : k - i 或 4-2 
和 之 前 一 样 ， 第 一 个 值 表示 新 切片 开始 的 元 素 的 索引 位 置 ， 这 个 例子 中 是 2。 第 二 个 值 表示 
开始 的 索引 位 置 (2 ) 加 上 希望 包括 的 元 素 的 个 数 ( 1 )，2+1 的 结果 是 3， 所 以 第 二 个 值 就 是 3。 为 
了 设置 容量 ， 从 索引 位 置 2 开始 ， 加 上 和 希望 容量 中 包含 的 元 素 的 个 数 ( 2 )， 就 得 到 了 第 三 个 值 4。 
如 果 试 图 设置 的 容量 比 可 用 的 容量 还 大 ， 就 会 得 到 一 个 语言 运行 时 错误 ， 如 代码 清单 4-35 所 示 。 


二 
之 


代码 清单 4-35 ”设置 容量 大 于 已 有 容量 的 语言 运行 时 错误 





// 这 个 切片 操作 试图 设置 容量 为 4 
// 这 比 可 用 的 容量 大 


slice := source[2:3:6] 






































Runtime Error: 
panic: runtime error: slice bounds out of range 


我 们 之 前 讨论 过 ,内置 函数 appeng 会 首先 使 用 可 用 容量 。 一 旦 没有 可 用 容量 , 会 分 配 一 个 
新 的 底层 数组 。 这 导致 很 容易 忘记 切片 间 正 在 共享 同一 个 底层 数组 。 一 旦 发 生 这 种 情况 , 对 切片 
进行 修改 ,很 可 能 会 导致 随机 且 奇 怪 的 问题 。 对 切片 内 容 的 修改 会 影响 多 个 切片 , 却 很 难 找到 问 
题 的 原因 。 

如 果 在 创建 切片 时 设置 切片 的 容量 和 长 度 一 样 ， 就 可 以 强制 让 新 切片 的 第 一 个 appenq 操作 
创建 新 的 底层 数组 , 与 原 有 的 底层 数组 分 离 。 新 切片 与 原 有 的 底层 数组 分 离 后 ,可 以 安全 地 进行 
后 续 修 改 ， 如 代码 清单 4-36 所 示 。 
































代码 清单 4-36 ”设置 长 度 和 容量 一 样 的 好 处 











// 创建 字符 串 切片 
// 其 长 度 和 容量 都 是 5 个 元 素 
source := []string{"Apple", "Orange", "Plum", "Banana", "Grape" } 


























// 对 第 三 个 元 素 做 切片 ， 并 限制 容量 
// 其 长 度 和 容量 都 是 1 个 元 素 
slice := source[2:3:3] 
































// 向 slice 追加 新 字符 串 
slice = append (slice, "Kiwi") 


如 果 不 加 第 三 个 索引 ， 由 于 剩余 的 所 有 容量 都 属于 slice， 向 slice 追加 Kiwi 会 改变 
原 有 底层 数组 索引 为 3 的 元 素 的 值 Banana。 不 过 在 代码 清单 4-36 中 我 们 限制 了 slice 的 容 
量 为 1。 当 我 们 第 一 次 对 slice 调用 appeng 的 时 候 ， 会 创建 一 个 新 的 底层 数组 ， 这 个 数组 包 
括 2 个 元 素 ， 并 将 水 果 Plum 复制 进来 ， 再 追加 新 水 果 Kiwi ， 并 返回 一 个 引用 了 这 个 底层 数组 
的 新 切片 ， 如 图 4-18 所 示 。 

因为 新 的 切片 slice 拥有 了 自己 的 底层 数组 ， 所 以 杜绝 了 可 能 发 生 的 问题 。 我 们 可 以 继续 
向 新 切片 里 追加 水 果 ， 而 不 用 担心 会 不 小 心 修改 了 其 他 切片 里 的 水 果 。 同 时 ,也 保持 了 为 切片 申 

















请 新 的 底层 数组 的 简洁 。 


内 置 函 数 append 也 是 一 个 可 变 参数 的 函数 。 


如 果 使 用 .. 


slice := source[2:3:3] 


地 址 1 
指针 长 度 
[0] [1] [2] 


ee 


slice = i "Kiwi" 奈 琳 
区 
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图 4-18 append 操作 之 后 的 新 切片 的 表示 

















这 意味 着 可 以 在 一 次 调用 传递 多 个 追加 的 值 。 


-运算 符 ， 可 以 将 一 个 切片 的 所 有 元 素 追 加 到 男 一 个 切片 里 ， 如 代码 清单 4-37 所 示 。 


代码 清单 4-37 ”将 一 个 切片 追加 到 另 一 个 切片 


// 创建 两 个 切片 ， 并 分 别 用 两 个 整数 进行 初始 化 





sl := 
S2 := 





[Ent(Ly.. 23} 
[]int{3, 4} 





// 将 两 个 切片 追加 在 一 起 ， 并 显示 结果 
fmt.Printf("%$v\n", append(sl, s2...)) 


Output: 


[me 


4] 


就 像 通过 输出 看 到 的 那样 ， 切 片 s2 里 的 所 有 值 都 追加 到 了 切片 sl 的 后 面 。 使 用 Printf 


时 用 来 显示 


append 因数 返回 的 新 切片 的 值 。 


迭代 切片 


既然 切片 是 一 个 集合 ， 可 以 迭代 其 中 的 元 素 。Go 语言 有 个 特殊 的 关键 字 range， 








合 关键 字 for 来 适 代 切片 里 的 元 素 ， 如 代码 清单 4-38 所 示 。 


代码 清单 4-38 使 用 for zange 迭代 切 卢 


// 创建 一 个 整 型 切片 























// 其 长 


slice 





度 和 容量 都 是 4 个 元 素 
:= [J]int{10, 20, 30, 40} 


它 可 以 配 











// 迭代 每 一 个 元 素 ， 并 显示 其 值 
for index, value := range slice { 

fmt.Printf("Index: %d Value: gd\n", index, value) 
} 





Output: 

Index: 0 Value: 10 
Index: 1 Value: 20 
Index: 2 Value: 30 


Index: 3 Value: 40 


当 迭 代 切 片 时 ， 关 键 字 range 会 返回 两 个 值 。 第 一 个 值 是 当前 迭代 到 的 索引 位 置 ， 第 二 个 
值 是 该 位 置 对 应 元 素 值 的 一 份 副本 ( 见 图 4-19 )。 


slice := [Jint{10, 20, 30, 40} 
地 址 4 4 
指针 长 度 容量 


[0] a [2] [3] 


| 

| 
| [a | | 四 
索引 索引 


for index, value := range slice { 











图 4-19 使 用 range 和 迭代 切片 会 创建 每 个 元 素 的 副本 


需要 强调 的 是 ，range 创建 了 每 个 元 素 的 副本 ， 而 不 是 直接 返回 对 该 元 素 的 引用 ， 如 代码 
清单 4-39 所 示 。 如 果 使 用 该 值 变 量 的 地 址 作为 指向 每 个 元 素 的 指针 ， 就 会 造成 错误 。 让 我 们 看 看 
是 为 什么 。 














代码 清单 4-39 ”range 提供 了 每 个 元 素 的 副本 
// 创建 一 个 整 型 切片 























// 其 长 度 和 容量 都 是 4 个 元 素 
slice := []int{10, 20, 30, 40} 





// 迭代 每 个 元 素 ， 并 显示 值 和 地 址 
for index, value := range slice { 
fmt.Printf("Value: %d Value-Addr: %X ElemAddr: Sx\n", 
Value &value, &slice[index]) 


Out puts 

Value: 10 Value-Addr: 10500168 ElemAddr: 1052E100 
Value: 20 Value-Addr: 10500168 ElemAddr: 1052E104 
Value: 30 Value-Addr: 10500168 ElemAddr: 1052E108 
Value: 40 Value-Addr: 10500168 ElemAddr: 1052E10C 


因为 迭代 返回 的 变量 是 一 个 迭代 过 程 中 根据 切片 依次 赋值 的 新 变量 ， 所 以 value 的 地 址 总 
是 相同 的 。 要 想 获取 每 个 元 素 的 地 址 ， 可 以 使 用 切片 变量 和 索引 值 。 
如 果 不 需要 索引 值 ， 可 以 使 用 占 位 字符 来 忽略 这 个 值 ， 如 代码 清单 4-40 所 示 。 


代码 清单 4-40 ”使 用 空白 标识 符 〈 下 划 线 ) 来 忽略 索引 值 
// 创建 一 个 整 型 切片 


























// 其 长 度 和 容量 都 是 4 个 元 素 
slice := []int{10, 20, 30, 40} 




















// 迭代 每 个 元 素 ， 并 显示 其 值 
for , value := range slice { 
fmt.Printf("Value: Sd\n", value) 





} 


Outputs 

Value: 10 
Value: 20 
Value: 30 
Value: 40 


关键 字 range 总 是 会 从 切片 头 部 开始 迭代 。 如 果 想 对 和 迭 代 做 更 多 的 控制 ， 依 旧 可 以 使 用 传 
统 的 for 循环 ， 如 代码 清单 4-41 所 示 。 








代码 清单 4-41 ”使 用 传统 的 for 循环 对 切片 进行 迭代 
// 创建 一 个 整 型 切片 























// 其 长 度 和 容量 都 是 4 个 元 素 
slice := []int{10, 20, 30, 40} 





// 从 第 三 个 元 素 开 始 迭 代 每 个 元 素 
for index := 2; index < len(slice); inqex++ { 
fmt.Printf("Index: %d Value: %d\n", index, slice[index]) 





} 


Output: 
Index: 2 Value: 30 
Index: 3 Value: 40 


有 两 个 特殊 的 内 置 函 数 len 和 cap, 可 以 用 于 处 理 数组 、 切 片 和 通道 。 对 于 切片 ,函数 len 
返回 切片 的 长 度 ， 函 数 cap 返回 切片 的 容量 。 在 代码 清单 4-41 里 , 我们 使 用 函数 len 来 决定 什 
么 时 候 停止 对 切片 的 迭代 。 

现在 知道 了 如 何 创建 和 使 用 切片 。 可 以 组 合 多 个 切片 成 为 多 维 切片 ， 并 对 其 进行 迭代 。 


4.2.4 ”多 维 切 片 


和 数组 一 样 ， 切 片 是 一 维 的 。 不 过 ， 和 之 前 对 数组 的 讨论 一 样 ， 可 以 组 合 多 个 切片 形成 多 维 
切片 ， 如 代码 清单 4-42 所 示 。 


代码 清单 4-42 ”声明 多 维 切片 


// 创建 一 个 整 型 切片 的 切片 
slice := [][]int{{10}, {100, 200}} 


我 们 有 了 一 个 包含 两 个 元 素 的 外 层 切片 ， 每 个 元 素 包 含 一 个 内 层 的 整 型 切片 。 切 片 slice 
的 值 看 起 来 像 图 4-20 展示 的 样子 。 











slice := [][]int{{10}, {100, 200}} 


指针 长 度 





[0] [0] [1] 


| 


图 4-20” 整 型 切片 的 切片 的 值 








在 图 4-20 里 ， 可 以 看 到 组 合 切片 的 操作 是 如 何 将 一 个 切片 嵌入 到 另 一 个 切片 中 的 。 外 层 的 
切片 包括 两 个 元 素 ， 每 个 元 素 都 是 一 个 切片 。 第 一 个 元 素 中 的 切片 使 用 单个 整数 10 来 初始 化 ， 
第 二 个 元 素 中 的 切片 包括 两 个 整数 ， 即 100 和 200。 

这 种 组 合 可 以 让 用 户 创建 非常 复杂 且 强 大 的 数据 结构 。 已 经 学 过 的 关于 内 置 函 数 append 
的 规则 也 可 以 应 用 到 组 合 后 的 切片 上 ， 如 代码 清单 4-43 所 示 。 


代码 清单 4-43 ”组 合 切片 的 切片 


// 创建 一 个 整 型 切片 的 切片 
slice := [][]int{{10}, {100, 200}} 








// 为 第 一 个 切片 追加 值 为 20 的 元 素 
slice[0] = append (slice[0], 20) 


Go 语言 里 使 用 append 函数 处 理 追加 的 方式 很 简明 : 先 增长 切片 ， 再 将 新 的 整 型 切片 赋值 
给 外 层 切 片 的 第 一 个 元 素 。 当 代码 清单 4-43 中 的 操作 完成 后 ， 会 为 新 的 整 型 切片 分 配 新 的 底层 数 
组 ， 然 后 将 切片 复制 到 外 层 切 片 的 索引 为 0 的 元 素 ， 如 图 4-21 所 示 。 





slice := [] [J]int{{10}, {100, 200}} 





append 之 前 append 之 后 





图 4-21 append 操作 之 后 外 层 切 片 索引 为 0 的 元 素 的 布局 





即便 是 这 么 简单 的 多 维 切 片 , 操作 时 也 会 涉及 众多 布局 和 值 。 看 起 来 在 函数 间 像 这 样 传递 数 
据 结 构 也 会 很 复杂 。 不 过 切片 本 身 结构 很 简单 ， 可 以 以 很 小 的 成 本 在 函数 间 传 递 。 





4.2.5 在 函数 间 传 递 切片 


在 函数 间 传 递 切片 就 是 要 在 函数 间 以 值 的 方式 传递 切片 。 由 于 切片 的 尺 二 很 小 , 在 函数 间 复 
制 和 传递 切片 成 本 也 很 低 。 让 我 们 创建 一 个 大 切片 ， 并 将 这 个 切片 以 值 的 方式 传递 给 函数 foo， 
如 代码 清单 4-44 所 示 。 





代码 清单 4-44 在 函数 间 传 递 切片 
// 分 配 包含 100 万 个 整 型 值 的 切片 


slice := make([]int, le6) 





// 将 slice 传递 到 函数 foo 


slice = foo(slice) 


// 函数 foo 接收 一 个 整 型 切片 ， 并 返回 这 个 切片 


func foo(slice []int) []int 








return slice 


} 
在 64 位 架构 的 机 器 上 ， 一 个 切片 需要 24 字 节 的 内 存 : 指针 字段 需要 8 字 节 ， 长 度 和 容量 


姓 


字段 分 别 需 要 8 字 节 。 由 于 与 切片 关联 的 数据 包含 在 底层 数组 里 ,不 属于 切片 本 身 ， 所 以 将 切片 
复制 到 任意 函数 的 时 候 ， 对 底层 数组 大 小 都 不 会 有 影响 。 复制 时 只 会 复制 切片 本 身 , 不 会 涉及 底 
层 数组 ( 见 图 4-22 )。 















函数 main 
slice := make([]int ，1000000) 
地 址 1000000 1000000 
指针 长 度 容量 
函数 调用 时 复制 切片 
[0] [1] [2] [3] [4] 
函数 foo 
func foo(slice []int) []int 
1000000 “|‖ 1000000 | 画 数 返回 时 复制 切片 
长 度 容量 














图 4-22 ”函数 调用 之 后 两 个 切片 指向 同一 个 底层 数组 


在 函数 间 传 递 24 字 节 的 数据 会 非常 快速 、 简 单 。 这 也 是 切片 效率 高 的 地 方 。 不 需要 传递 指 
针 和 处 理 复杂 的 语法 , 只 需要 复制 切片 , 按 想 要 的 方式 修改 数据 , 然后 传递 回 一 份 新 的 切片 副本 。 





WX ”映射 的 内 部 实现 和 基础 功能 
映射 是 一 种 数据 结构 ， 用 于 存储 一 系列 无 序 的 键 值 对 。 


映射 里 基于 键 来 存储 值 。 图 4-23 通过 一 个 例子 展示 了 映射 里 键 值 对 是 如 何 存储 的 。 映 射 功 
能 强大 的 地 方 是， 能够 基于 键 快速 检索 数据 。 键 就 像 索引 一 样 ， 指 向 与 该 键 关 联 的 值 。 


Red #da1337 Orange #e95a22 Green #a3ff47 
键 值 键 值 键 值 


图 4-23 ” 键 值 对 的 关系 























4.3.1 内 部 实现 
映射 是 一 个 集合 , 可 以 使 用 类 似 处 理 数组 和 切片 的 方式 迭代 映射 中 的 元 素 。 但 映射 是 无 序 的 





集合 , 意味 着 没有 办 法 预测 键 值 对 被 返回 的 顺序 。 即 便 使 用 同样 的 顺序 保存 键 值 对 ,每 次 迭代 映 
射 的 时 候 顺 序 也 可 能 不 一 样 。 无 序 的 原因 是 映射 的 实现 使 用 了 散 列 表 ， 见 图 4-24。 











映射 散 列表 
| 散 列 值 低位 散 列 值 低位 散 列 值 低 位 散 列 值 低 位 








[1] [2] [3] [4] [5] [6] [7] 


[0] 
散 列 | 散 列 | 散 列 | 散 列 | 散 列 | || 
值 高 位 | 值 高 位 | 值 高 位 | 值 高 位 | 值 高 位 





数组 使 用 散 列 值 高 位 来 区 分 不 同 项 


[ees |e) lss 


键 和 值 被 打包 在 一 起 




















图 4-24 ”映射 的 内 部 结构 的 简单 表示 














映射 的 散 列表 包含 一 组 桶 。 在 存储 、 删 除 或 者 查找 键 值 对 的 时 候 ， 所 有 操作 都 要 先 选择 一 个 
桶 。 把 操作 映射 时 指定 的 键 传 给 映射 的 散 列 函数 ， 就 能 选中 对 应 的 桶 。 这 个 散 列 函 数 的 目的 是 生 
成 一 个 索引 ， 这 个 索引 最 终 将 键 值 对 分 布 到 所 有 可 用 的 桶 里 。 

随 着 映射 存储 的 增加 ,索引 分 布 越 均 匀 ， 访 问 键 值 对 的 速度 就 越 快 。 如 果 你 在 映射 里 存储 了 
10 000 个 元 素 ， 你 不 希望 每 次 查找 都 要 访问 10 000 个 键 值 对 才能 找到 需要 的 元 素 ， 你 希望 查找 
键 值 对 的 次 数 越 少 越 好 。 对 于 有 10 000 个 元 素 的 映射 ， 每 次 查找 只 需要 查找 8 个 键 值 对 才 是 一 
个 分 布 得 比较 好 的 映射 。 映 射 通过 合理 数量 的 桶 来 平衡 键 值 对 的 分 布 。 

Go 语言 的 映射 生成 散 列 键 的 过 程 比 图 4-25 展示 的 过 程 要 稍微 长 一 些 , 不 过 大 体 过 程 是 类 似 
的 。 在 我 们 的 例子 里 ， 键 是 字符 串 ， 代 表 颜 色 。 这 些 字符 串 会 转换 为 一 个 数值 ( 散 列 值 )。 这 个 
数值 落 在 映射 已 有 桶 的 序号 范围 内 表示 一 个 可 以 用 于 存储 的 桶 的 序号 。 之 后 , 这 个 数值 就 被 用 于 
选择 桶 ， 用 于 存储 或 者 查找 指定 的 键 值 对 。 对 Go 语言 的 映射 来 说 ， 生 成 的 散 列 键 的 一 部 分 ， 具 
体 来 说 是 低位 (LOB )， 被 用 来 选择 桶 。 

如 果 再 仔细 看 看 图 4-24, 就 能 看 出 桶 的 内 部 实现 。 映射 使 用 两 个 数据 结构 来 存储 数据 。 第 一 
个 数据 结构 是 一 个 数组 ,内 部 存储 的 是 用 于 选择 桶 的 散 列 键 的 高 八 位 值 。 这 个 数组 用 于 区 分 每 个 
键 值 对 要 存在 哪个 桶 里 。 第 二 个 数据 结构 是 一 个 字 节 数组 , 用 于 存储 键 值 对 。 该 字 节 数组 先 依次 






























































存储 了 这 个 桶 里 所 有 的 键 ,之 后 依次 存储 了 这 个 桶 里 所 有 的 值 。 实 现 这 种 键 值 对 的 存储 方式 目的 
在 于 减少 每 个 桶 所 需 的 内 存 。 


键 散 列 值 / 桶 


Se 





= 


图 4-25 简单 描述 散 列 函数 是 如 何 工作 的 




















映射 底层 的 实现 还 有 很 多 细节 , 不 过 这 些 细节 超出 了 本 书 的 范畴 。 创 建 并 使 用 映射 并 不 需要 
了 解 所 有 的 细节 ， 只 要 记 住 一 件 事 : 映射 是 一 个 存储 键 值 对 的 无 序 集合 。 





4.3.2 创建 和 初始 化 


Go 语言 中 有 很 多 种 方法 可 以 创建 并 初始 化 映射 ,可 以 使 用 内 置 的 make 函数 ( 如 代码 清单 4-45 
所 示 )， 也 可 以 使 用 映射 字面 量 。 








代码 清单 4-45 ”使 用 make 声明 映射 
// 创建 一 个 映射 ， 键 的 类 型 是 string， 值 的 类 型 是 int 


dict := make (map[string]int) 








// 创建 一 个 映射 ， 键 和 值 的 类 型 都 是 string 
// 使 用 两 个 键 值 对 初始 化 映射 
dict := map[string]string{"Red": "#dal337", "Orange": "#e95a22"} 


创建 映射 时 , 更 常用 的 方法 是 使 用 映射 字面 量 。 映射 的 初始 长 度 会 根据 初始 化 时 指定 的 键 值 
对 的 数量 来 确定 。 

映射 的 键 可 以 是 任何 值 。 这 个 值 的 类 型 可 以 是 内 置 的 类 型 ,也 可 以 是 结构 类 型 ,只 要 这 个 值 
可 以 使 用 == 运 算 符 做 比较 。 切 片 、 函 数 以 及 包含 切片 的 结构 类 型 这 些 类 型 由 于 具有 引用 语义 ， 
不 能 作为 映射 的 键 ， 使 用 这 些 类 型 会 造成 编译 错误 ， 如 代码 清单 4-46 所 示 。 











代码 清单 4-46 ”使 用 映射 字面 量 声明 空 映射 


// 创建 一 个 映射 ， 使 用 字符 串 切片 作为 映射 的 键 
dict := map[[]string]int{} 














Compiler Exception: 
invalid map key type [lstring 


没有 任何 理由 阻止 用 户 使 用 切片 作为 映射 的 值 ， 如 代码 清单 4-47 所 示 。 这 个 在 使 用 一 个 映射 
键 对 应 一 组 数据 时 ， 会 非常 有 用 。 


代码 清单 4-47 ”声明 一 个 存储 字符 串 切片 的 映射 
// 创建 一 个 映射 ， 使 用 字符 串 切 片 作为 值 
dict := map[int][]string{} 














4.3.3 ”使 用 映射 
键 值 对 赋值 给 映射 ， 是 通过 指定 适当 类 型 的 键 并 给 这 个 键 赋 一 个 值 来 完成 的 ， 如 代码 清 
单 4-48 所 示 。 


代码 清单 4-48 ”为 映射 赋值 
// 创建 一 个 空 映射 ， 用 来 存储 颜色 以 及 颜色 对 应 的 十 六 进 制 代码 


colors := map[string]string{} 















































// 将 Red 的 代码 加 入 到 映射 
colors["Red"] = "#dal337" 


可 以 通过 声明 一 个 未 初始 化 的 映射 来 创建 一 个 值 为 nil 的 映射 ( 称 为 nil 蜡 | ), nil 映射 
不 能 用 于 存储 键 值 对 ， 否 则 ， 会 产生 一 个 语言 运行 时 错误 ， 如 代码 清单 4-49 所 示 。 





代码 清单 4-49 对 nil 映射 赋值 时 的 语言 运行 时 错误 
// 通过 声明 映射 创建 一 个 nil 映射 




















Var colors map[lstring]string 


// 将 Red 的 代码 加 入 到 映射 
colors["Red"] = "#dal337" 


Runtime Error: 
panic: runtime error: assignment to entry in nil map 


测试 映射 里 是 否 存 在 某 个 键 是 映射 的 一 个 重要 操作 。 这 个 操作 人 允许 用 户 写 一些 逻 辑 来 确定 是 
否 完 成 了 某 个 操作 或 者 是 否 在 映射 里 缓存 了 特定 数据 。 这 个 操作 也 可 以 用 来 比较 两 个 映射 ,来 确 
定 哪些 键 值 对 互相 匹配 ， 哪 些 键 值 对 不 匹配 。 

从 映射 取 值 时 有 两 个 选择 。 第 一 个 选择 是 ,可 以 同时 获得 值 ， 以 及 一 个 表示 这 个 键 是 否 存在 
的 标志 ， 如 代码 清单 4-50 所 示 。 


代码 清单 4-50 ”从 映射 获取 值 并 判断 键 是 否 存在 


// 获取 键 Blue 对 应 的 值 


Value exists := colors["Blue"] 




















// 这 个 键 存在 吗 ? 
if exists 
fmt .Println (value) 





} 
另 一 个 选择 是 ， 只 返回 键 对 应 的 值 ， 然 后 通过 判断 这 个 值 是 不 是 零 值 来 确定 键 是 否 存在 ， 如 
代码 清单 4-51 所 示 。” 


代码 清单 4-51 ”从 映射 获取 值 ， 并 通过 该 值 判断 键 是 否 存 在 





// 获取 键 Blue 对 应 的 值 


Value := colors["Blue"] 


// 这 个 键 存在 吗 ? 
if value != "™ { 
fmt .Println (value) 





} 

在 Go 语言 里 , 通过 键 来 索引 映射 时 ,即便 这 个 键 不 存在 也 总 会 返回 一 个 值 。 在 这 种 情况 下 ， 
返回 的 是 该 值 对 应 的 类 型 的 零 值 。 

和 迭代 映射 里 的 所 有 值 和 迭代 数组 或 切片 一 样 ， 使 用 关键 字 range， 如 代码 清单 4-52 所 示 。 
但 对 映射 来 说 ，range 返回 的 不 是 索引 和 值 ， 而 是 键 值 对 。 


代码 清单 4-52 ”使 用 range 迭代 映射 


// 创建 一 个 映射 ， 存 储 颜色 以 及 颜色 对 应 的 十 六 进 制 代码 



































colors := maplstring] stringt{ 
"AliceBlue": "#£0f8f£f£", 
"Coral": "#f£f7F50", 
"DarkGray™": "#a9a9a9", 
"ForestGreen": "#228b22", 


} 


// 显示 映射 里 的 所 有 颜色 
for key, value := range Colors { 
fmt.Printf("Key: %s Value: %s\n", key, value) 





} 
如 果 想 把 一 个 键 值 对 从 映射 里 删除 ， 就 使 用 内 置 的 delete 函数 ， 如 代码 清单 4-53 所 示 。 





代码 清单 4-53 ”从 映射 中 删除 一 项 
// 删除 键 为 coral 的 键 值 对 


deletel(colors, "Coral") 


// 显示 映射 里 的 所 有 颜色 
for key, value := range Colors { 
fmt.Printf("Key: %s Value: %s\n", key, value) 





} 


Q) 这 种 方法 只 能 用 在 映射 存储 的 值 都 是 非 零 值 的 情况 。 译 者 注 





这 次 在 迭代 映射 时 ， 颜 色 Coral 不 会 显示 在 屏幕 上 。 


4.3.4 在 函数 间 传 递 映 射 


在 函数 间 传 递 映射 并 不 会 制造 出 该 映射 的 一 个 副本 。 实 际 上 ， 当 传递 映射 给 一 个 函数 ， 并 对 
这 个 映射 做 了 修改 时 ， 所 有 对 这 个 映射 的 引用 都 会 察觉 到 这 个 修改 ， 如 代码 清单 4-54 所 示 。 


代码 清单 4-54 ”在 函数 间 传 递 映射 

















func main() { 
// 创建 一 个 映射 ， 存 储 颜 色 以 及 颜色 对 应 的 十 六 进 制 代码 
colors := map[lstring] stringt{ 
"AliceBlue": "#£0f8f£f", 
POL "EE 7ESON, 
"DarkGray™": "#a9a9a9", 


"FOrestGreen": "#228b22", 
} 


// 显示 映射 里 的 所 有 颜色 
for key, value := range Colors { 
fmt.Printf("Key: %s Value: %s\n", key, value) 





} 











// 调用 函数 来 移 除 指定 的 键 


removeColor (colors, "Coral") 





// 显示 映射 里 的 所 有 颜色 
for key, value := range colors { 
fmt.Printf("Key: %s Value: %s\n", key, value) 





} 
} 


// removeColor 将 指定 映射 里 的 键 删除 

func removeColor (colors mapl[lstring]string, key string) { 
deletel(colors, key) 

} 


如 果 运 行 这 个 程序 ， 会 得 到 代码 清单 4-55 所 示 的 输出 。 


代码 清单 4-55 ”代码 清单 4-54 的 输出 


Key: AliceBlue Value: #FOF8FF 
Key: Coral Value: #FF7F50 

Key: DarkGray Value: #A9A9A9 
Key: ForestGreen Value: #228B22 


Key: AliceBlue Value: #FOF8FF 
Key: DarkGray Value: #A9A9A9 
Key: ForestGreen Value: #228B22 


可 以 看 到 ， 在 调用 了 removeColor 之 后 ，main 函数 里 引用 的 映射 中 不 再 有 Coral 颜色 





了 。 这 个 特性 和 切片 类 似 ， 保 证 可 以 用 很 小 的 成 本 来 复制 映射 。 


we 小 结 


数组 是 构造 切片 和 映射 的 基石 。 

Go 语言 里 切片 经 常用 来 处 理 数据 的 集合 ， 映 射 用 来 处 理 具 有 键 值 对 结构 的 数据 。 

内 置 函数 make 可 以 创建 切片 和 映射 ， 并 指定 原始 的 长 度 和 容量 。 也 可 以 直接 使 用 切片 
和 了 映射 字面 量 ， 或 者 使 用 字面 量 作为 变量 的 初始 值 。 

切片 有 容量 限制 ， 不 过 可 以 使 用 内 置 的 append 函数 扩展 容量 。 

映射 的 增长 没有 容量 或 者 任何 限制 。 

内 置 函数 len 可 以 用 来 获取 切片 或 者 映射 的 长 度 。 

内 置 函 数 cap 只 能 用 于 切片 。 

通过 组 合 , 可 以 创建 多 维 数组 和 多 维 切片 。 也 可 以 使 用 切片 或 者 其 他 映射 作为 映射 的 值 。 
但 是 切片 不 能 用 作 映 射 的 键 。 
将 切片 或 者 映射 传递 给 函数 成 本 很 小 ， 并 且 不 会 复制 底层 的 数据 结构 。 







































































第 5 曹 Go 话 言 的 类 型 系统 





本 章 主要 内 容 

声明 新 的 用 户 定 义 的 类 型 

使 用 方法 ， 为 类 型 增加 新 的 行为 
了 解 何 时 使 用 指针 ， 何 时 使 用 值 
通过 接口 实现 多 态 

通过 组 合 来 扩展 或 改变 类 型 
公开 或 者 未 公开 的 标识 符 





Go 语言 是 一 种 静态 类 型 的 编程 语言 。 这 意味 着 ， 编 译 器 需要 在 编译 时 知晓 程序 里 每 个 值 的 

类 型 。 如 果 提 前 知道 类 型 信息 , 编译 器 就 可 以 确保 程序 合理 地 使 用 值 。 这 有 助 于 减少 潜在 的 内 存 
异常 和 bug， 并 且 使 编译 器 有 机 会 对 代码 进行 一 些 性 能 优化 ， 提 高 执行 效率 。 
值 的 类 型 给 编译 器 提供 两 部 分 信息 : 第 一 部 分 , 需要 分 配 多 少 内 存 给 这 个 值 ( 即 值 的 规模 ); 
第 二 部 分 ， 这 段 内 存 表示 什么 。 对 于 许多 内 置 类 型 的 情况 来 说 ， 规 模 和 表示 是 类 型 名 的 一 部 分 。 
int64 类 型 的 值 需要 8 字 往 (64 位 ), 表示 一 个 整数 值 ; float32 类 型 的 值 需要 4 字 记 (32 们 ， 
表示 一 个 EEE-754 定义 的 二 进 制 浮 点 数 ; bool 类 型 的 值 需要 1 字 节 (8 位 ), 表示 布尔 值 true 
和 false。 

有 些 类 型 的 内 部 表示 与 编译 代码 的 机 器 的 体系 结构 有 关 。 例如 , 根据 编译 所 在 的 机 器 的 体系 
结构 ， 一 个 int 值 的 大 小 可 能 是 8 字 节 (64 位 )， 也 可 能 是 4 字 节 (32 位 )。 还 有 一 些 与 体系 结 
构 相 关 的 类 型 ， 如 Go 语言 里 的 所 有 引用 类 型 。 好 在 创建 和 使 用 这 些 类 型 的 值 的 时 候 ， 不 需要 了 
解 这 些 与 体系 结构 相关 的 信息 。 但 是 ， 如 果 编 译 器 不 知道 这 些 信息 ,就 无 法 阻止 用 户 做 一 些 导致 
程序 受 损 甚 至 机 器 故障 的 事情 。 
































































































































































































































xse 用 户 定义 的 类 型 


Go 语言 允许 用 户 定义 类 型 。 当 用 户 声 明 一 个 新 类 型 时 ， 这 个 声明 就 给 编译 噩 提供 了 一 个 杠 











架 ， 告 知 必 要 的 内 存 大 小 和 表示 信息 。 声 明 后 的 类 型 与 内 路 类 型 的 运作 方式 类 似 。Go 语言 里 声 
明 用 户 定义 的 类 型 有 两 种 方法 。 最 常用 的 方法 是 使 用 关键 字 struct， 它 可 以 让 用 户 创建 一 个 结 
构 类 型 。 

结构 类 型 通过 组 合 一 系列 固定 且 唯 一 的 字段 来 声明 ， 如 代码 清单 5-1 所 示 。 结 构 里 每 个 字段 
都 会 用 一 个 已 知 类 型 声明 。 这 个 已 知 类 型 可 以 是 内 置 类 型 ， 也 可 以 是 其 他 用 户 定义 的 类 型 。 


代码 清单 5-1 声明 一 个 结构 类 型 


01 // user 在 程序 里 定义 一 个 用 户 类 型 
02 type user struct { 





























03 name string 
04 email string 
05 ext init 

06 privileged bool 
07: 








在 代码 清单 5-1 中 ， 可 以 看 到 一 个 结构 类 型 的 声明 。 这 个 声明 以 关键 字 type 开始 ， 之 后 是 
新 类 型 的 名 字 ， 最 后 是 关键 字 struct 。 这 个 结构 类 型 有 4 个 字段 ， 每 个 字段 都 基于 一 个 内 置 类 
型 。 读 者 可 以 看 到 这 些 字段 是 如 何 组 合成 一 个 数据 的 结构 的 。 一 旦 声明 了 类 型 ( 如 代码 清单 5-2 
所 示 )， 就 可 以 使 用 这 个 类 型 创建 值 。 











代码 清单 5-2 ”使 用 结构 类 型 声明 变量 ， 并 初始 化 为 其 零 值 
09 // 声明 user 类 型 的 变量 














10 var bill user 

在 代码 清单 5-2 的 第 10 行 ， 关键 字 var 创建 了 类 型 为 user 且 名 为 bill 的 变量 。 当 声明 
变量 时 ， 这 个 变量 对 应 的 值 总 是 会 被 初始 化 。 这 个 值 要 么 用 指定 的 值 初始 化 ,要 么 用 零 值 ( 即 变 
量 类 型 的 默认 值 ) 做 初始 化 。 对 数值 类 型 来 说 ， 零 值 是 0; 对 字符 串 来 说 ， 零 值 是 空 字符 串 ; 对 
布尔 类 型 ， 零 值 是 false。 对 这 个 例子 里 的 结构 ， 结 构 里 每 个 字段 都 会 用 零 值 初始 化 。 

任何 时 候 , 创建 一 个 变量 并 初始 化 为 其 零 值 ,习惯 是 使 用 关键 字 var。 这 种 用 法 是 为 了 更 明 
确 地 表示 一 个 变量 被 设置 为 零 值 。 如 果 变 量 被 初始 化 为 某 个 非 零 值 ,就 配合 结构 字面 量 和 短 变量 
声明 操作 符 来 创建 变量 。 

代码 清单 5-3 展示 了 如 何 声 明 一 个 user 类 型 的 变量 ， 并 使 用 某 个 非 零 值 作为 初始 值 。 在 第 
13 行 ,我 们 首先 给 出 了 一 个 变量 名 ， 之 后 是 短 变 量 声明 操作 符 。 这 个 操作 符 是 冒号 加 一 个 等 号 
( := )。 一 个 短 变 量 声明 操作 符 在 一 次 操作 中 完成 两 件 事情 : 声明 一 个 变量 ， 并 初始 化 。 短 变量 
声明 操作 符 会 使 用 右 侧 给 出 的 类 型 信息 作为 声明 变量 的 类 型 。 






















































































代码 清单 5-3 ”使 用 结构 字面 量 来 声明 一 个 结构 类 型 的 变量 
12 // 声明 user 类 型 的 变量 ， 并 初始 化 所 有 字段 














13 lisa := usert{ 
14 name: "hiSa 
二 所 email: "jisalemail.com", 


16 exXt : 1237 
4 privileged: true, 
18.33 


既然 要 创建 并 初始 化 一 个 结构 类 型 ,我 们 就 使 用 结构 字面 量 来 完成 这 个 初始 化 ， 如 代码 清 
单 5-4 所 示 。 结 构 字面 量 使 用 一 对 大 括号 括 住 内 部 字段 的 初始 值 。 






































代码 清单 5-4 ”使 用 结构 字面 量 创建 结构 类 型 的 值 





14 name: va 

于 5 email: "lisa@email.com", 
16 ext: L233 

17 privileged: true, 

48 








结构 字面 量 可 以 对 结构 类 型 采用 两 种 形式 。 代 码 清 单 5-4 中 使 用 了 第 一 种 形式 ， 这 种 形式 在 
不 同行 声明 每 个 字段 的 名 字 以 及 对 应 的 值 。 字 段 名 与 值 用 冒号 分 陋 ,， 每 一 行 以 逗号 结尾 。 这 种 形 
式 对 字段 的 声明 顺序 没有 要 求 。 第 二 种 形式 没有 字段 名 , 只 声明 对 应 的 值 , 如 代码 清单 5-5 所 示 。 

















代码 清单 5-5 ”不 使 用 字段 名 ， 创 建 结 构 类 型 的 值 


12 // 声明 user 类 型 的 变量 
13 lisa := user{"Lisa", "lisalemail.com", 123, true} 


每 个 值 也 可 以 分 别 占 一 行 , 不 过 习惯 上 这 种 形式 会 写 在 一 行 里 , 结尾 不 需要 至 号。 这 种 形式 
下 , 值 的 顺序 很 重要 ， 必 须要 和 结构 声明 中 字段 的 顺序 一 致 。 当 声明 结构 类 型 时 ,字段 的 类 型 并 
不 限制 在 内 置 类 型 ， 也 可 以 使 用 其 他 用 户 定义 的 类 型 ， 如 代码 清单 5-6 所 示 。 


代码 清单 5-6 ”使 用 其 他 结构 类 型 声明 字段 


20 // admin 需要 一 个 user 类 型 作为 管理 者 ， 并 附加 权限 
21 type aqmin struct { 























22 person user 
23 level string 
24 } 








代码 清单 5-6 展示 了 一 个 名 为 admin 的 新 结构 类 型 。 这 个 结构 类 型 有 一 个 名 为 person 的 
user 类 型 的 字段 ， 还 声明 了 一 个 名 为 level 的 string 字段 。 当 创建 具有 person 这 种 字段 
的 结构 类 型 的 变量 时 ， 初 始 化 用 的 结构 字面 量 会 有 一 些 变化 ， 如 代码 清单 5-7 所 示 。 


代码 清单 5-7 使 用 结构 字面 量 来 创建 字段 的 值 


26 // 声明 admin 类 型 的 变量 

















27 fred := admint{ 

28 person: usert{ 

29 name: "Lisa", 

30 email: "lisalemail.com", 
3. ext: 123.; 


32 privileged: true, 


33 }v 
34 level: "super", 
35: 


为 了 初始 化 person 字段 ， 我 们 需要 创建 一 个 user 类 型 的 值 。 代 码 清单 5-7 的 第 28 行 就 
是 在 创建 这 个 值 。 这 行 代码 使 用 结构 字面 量 的 形式 创建 了 一 个 user 类 型 的 值 ， 并 赋 给 了 person 
字段 。 

另 一 种 声明 用 户 定 义 的 类 型 的 方法 是 ， 基 于 一 个 已 有 的 类 型 ， 将 其 作为 新 类 型 的 类 型 说 明 。 
当 需 要 一 个 可 以 用 已 有 类 型 表示 的 新 类 型 的 时 候 ， 这 种 方法 会 非常 好 用 ， 如 代码 清单 5-8 所 示 。 
标准 库 使 用 这 种 声明 类 型 的 方法 ， 从 内 置 类 型 创建 出 很 多 更 加 明确 的 类 型 ， 并 赋予 更 高 级 的 功能 。 


代码 清单 5-8 ”基于 int 64 声明 一 个 新 类 型 

type Duration int64 

代码 清单 5-8 展示 的 是 标准 库 的 time 包 里 的 一 个 类 型 的 声明 。Duration 是 一 种 描述 时 间 
间隔 的 类 型 ， 单 位 是 纳 秒 (ns )。 这 个 类 型 使 用 内 置 的 int 64 类 型 作为 其 表示 。 在 Duration 
类 型 的 声明 中 ， 我 们 把 int 64 类 型 叫 作 Duration 的 基础 类 型 。 不过, 虽然 int 64 是 基础 
类 型 ，Go 并 不 认为 Duration 和 int64 是 同一 种 类 型 。 这 两 个 类 型 是 完全 不 同 的 有 区 别 的 
类 型 。 

为 了 更 好 地 展示 这 种 区 别 ， 来 看 一 下 代码 清单 5-9 所 示 的 小 程序 。 这 个 程序 本 身 无 法 通过 
编译 。 


























代码 清单 5-9 给 不 同类 型 的 变量 赋值 会 产生 编译 错误 


01 Package main 





02 

03 type Duration int64 
04 

05 func main() { 

06 Var dur Duration 
07 dur = int64(1000) 
08 } 


代码 清单 5-9 所 示 的 程序 在 第 03 行 声 明了 Duration 类 型 。 之 后 在 第 06 行 声 明了 一 个 类 型 
为 Duration 的 变量 dur， 并 使 用 零 值 作为 初 值 。 之 后 ,第 7 行 的 代码 会 在 编译 的 时 候 产生 编 
译 错误 ， 如 代码 清单 5-10 所 示 。 


代码 清单 5-10 ”实际 产生 的 编译 错误 





Prog.go:7: cannot use int64(1000) (type int64) as type Duration 
in assignment 


编译 需 很 清楚 这 个 程序 的 问题 : 类 型 int 64 的 值 不 能 作为 类 型 Duration 的 值 来 用 。 换 名 
话说 ,虽然 int 64 类 型 是 基础 类 型 ，Duration 类 型 依然 是 一 个 独立 的 类 型 。 两 种 不 同类 型 的 
值 即便 互相 兼容 ， 也 不 能 互相 赋值 。 编 译 需 不 会 对 不 同类 型 的 值 做 隐 式 转换 。 


Xw 方法 


方法 能 给 用 户 定义 的 类 型 添加 新 的 行为 。 方 法 实际 上 也 是 函数 ， 只 
func 和 方法 名 之 间 增 加 了 一 个 参数 ， 如 代码 清单 5-11 所 示 。 























下 


在 声明 时 ， 在 关键 字 


代码 清单 5-11 listing11.go 


01 
02 
03 
04 
05 
06 
07 
08 








// 这 个 示例 程序 展示 如 何 声 明 
// 并 使 用 方法 


Package main 





Import ( 
TY fmt TY 
) 





// user 在 程序 里 定义 一 个 用 户 类 型 
type user struct { 
name string 








email string 


} 











// notify 使 用 值 接收 者 实现 了 一 个 方法 
func (u user) notify() { 
fmt.Printf("Sending User Email To %s<%s>\n", 
u.name, 
u.email) 





} 








// changeEmail 使 用 指针 接收 者 实现 了 一 个 方法 
func (u *user) changeEmail (email string) { 
u.email = email 








} 








// main 是 应 用 程序 的 入 
func main() { 
// user 类 型 的 值 可 以 用 来 调 
// 使 用 值 接收 者 声明 的 方法 
bill := user{"Bill", "billQ@email.com"} 
bill.notify() 




















村 























// 指向 user 类 型 值 的 指针 也 可 以 用 来 调用 
// 使 用 值 接收 者 声明 的 方法 

lisa := &user{"Lisa", "lisalemail.com"} 
lisa.notify() 
































// user 类 型 的 值 可 以 用 来 调用 
// 使 用 指针 接收 者 声明 的 方法 
bill.changeEmail ("bill@newdomain.com") 
bill.notify() 




















44 // 指向 user 类 型 值 的 指针 可 以 用 来 调用 
45 // 使 用 指针 接收 者 声明 的 方法 





46 lisa.changeEmail ("lisa@newdomain.com") 
47 lisa.notify() 
48 } 





代码 清单 5-11 的 第 16 行 和 第 23 行 展 示 了 两 种 类 型 的 方法 。 关 键 字 func 和 气 数 名 之 间 的 
参数 被 称 作 接 收 者 ,将 函数 与 接收 者 的 类 型 绑 在 一 起 。 如 果 一 个 函数 有 接收 者 ， 这 个 函数 就 被 称 
为 方法 。 当 运行 这 段 程序 时 ， 会 得 到 代码 清单 5-12 所 示 的 输出 。 


代码 清单 5-12 listing11.go 的 输出 


Sending User Email To Bill<bill@email.com> 
Sending User Email To Lisa<lisalemail.com> 
Sending User Email To Bill<bill@newdomain.com> 
Sending User Email To Lisa<lisa@comcast .com> 


让 我 们 来 解释 一 下 代码 清单 5-13 所 示 的 程序 都 做 了 什么 。 在 第 10 行 , 该 程序 声明 了 名 为 user 
的 结构 类 型 ， 并 声明 了 名 为 notify 的 方法 。 








代码 清单 5-13 listing11.go: 第 09 行 到 第 20 行 





09 // user 在 程序 里 定义 一 个 用 户 类 型 
10 type user struct { 








11 name string 
12 email string 
13.°} 

14 





15 // notify 使 用 值 接收 者 实现 了 一 个 方法 


16 func (u user) notify() { 


了 fmt.Printf("Sending User Email To %s<%s>\n", 
18 u.name, 

19 u.email) 

20 } 


Go 语言 里 有 两 种 类 型 的 接收 者 : 值 接收 者 和 指针 接收 者 。 在 代码 清单 5-13 的 第 16 行 , 使 
用 值 接收 者 声明 了 notify 方法 ， 如 代码 清单 5-14 所 示 。 


func (u user) notify() { 

notify 方法 的 接收 者 被 声明 为 user 类 型 的 值 。 如 果 使 用 值 接收 者 声明 方法 ， 调 用 时 会 使 
用 这 个 值 的 一 个 副本 来 执行 。 让 我 们 跳 到 代码 清单 5-11 的 第 32 行 来 看 一 下 如 何 调用 notify 方 
法 ， 如 代码 清单 5-15 所 示 。 


代码 清单 5-15 listing11.go: 第 29 行 到 第 32 行 





29 // user 类 型 的 值 可 以 用 来 调用 
30 // 使 用 值 接收 者 声明 的 方法 





3 bill := user{"Bill", "billQ@email.com"} 
32 bill.notify() 


代码 清单 5-15 展示 了 如 何 使 用 user 类 型 的 值 来 调用 方法 。 第 31 行 声明 了 一 个 user 类 型 
的 变量 bi11, 并 使 用 给 定 的 名 字 和 电子 邮件 地 址 做 初始 化 。 之 后 在 第 32 行 , 使 用 变量 bill 来 
调用 notify 方法 ， 如 代码 清单 5-16 所 示 。 





代码 清单 5-16 ”使 用 变量 来 调用 方法 

bill.notify() 

这 个 语法 与 调用 一 个 包 里 的 函数 看 起 来 很 类 似 。 但 在 这 个 例子 里 ，bi1l1l 不 是 包 名 ， 而 是 变 
量 名 。 这 上段 程序 在 调用 notify 方法 时 , 使 用 bill 的 值 作为 接收 者 进行 调用 ， 方 法 notify 
会 接收 到 bill 的 值 的 一 个 副本 。 

也 可 以 使 用 指针 来 调用 使 用 值 接收 者 声明 的 方法 ， 如 代码 清单 5-17 所 示 。 





代码 清单 5-17 listing11.go: 第 34 行 到 第 37 行 
34 // 指向 user 类 型 值 的 指针 也 可 以 用 来 调用 














35 // 使 用 值 接收 者 声明 的 方法 
36 lisa := &user{"Lisa", "lisal@email.com"} 
$7 lisa.notify() 


代码 清单 5-17 展示 了 如 何 使 用 指向 user 类 型 值 的 指针 来 调用 notify 方法 。 在 第 36 行 ， 
声明 了 一 个 名 为 1isa 的 指针 变量 ， 并 使 用 给 定 的 名 字 和 电子 邮件 地 址 做 初始 化 。 之 后 在 第 37 
行 , 使 用 这 个 指针 变量 来 调用 notify 方法 。 为 了 支持 这 种 方法 调用 ，Go 语言 调整 了 指针 的 值 ， 
来 符合 方法 接收 者 的 定义 。 可 以 认为 Go 语言 执行 了 代码 清单 5-18 所 示 的 操作 。 











代码 清单 5-18 Go 在 代码 背后 的 执行 动作 


(*1isa) .notify() 





代码 清单 5-18 展示 了 Go 编译 絮 为 了 支持 这 种 方法 调用 背后 做 的 事情 。 指 针 被 解 引 用 为 值 ， 
这 样 就 符合 了 值 接收 者 的 要 求 。 再 强调 一 次 ，notify 操作 的 是 一 个 副本 ， 只 不 过 这 次 操作 的 是 
从 lisa 指针 指向 的 值 的 副本 。 

也 可 以 使 用 指针 接收 者 声明 方法 ， 如 代码 清单 5-19 所 示 。 


代码 清单 5-19 listing11.go: 第 22 行 到 第 25 行 





22 // changeEmail 使 用 指针 接收 者 实现 了 一 个 方法 
23 func (ua *user) changeEmail (email string) { 
24 u.email = email 


代码 清单 5-19 展示 了 changeEmail 方法 的 声明 。 这 个 方法 使 用 指针 接收 者 声明 。 这 个 接 
收 者 的 类 型 是 指向 user 类 型 值 的 指针 ， 而 不 是 user 类 型 的 值 。 当 调用 使 用 指针 接收 者 声明 的 
方法 时 ， 这 个 方法 会 共享 调用 方法 时 接收 者 所 指向 的 值 ， 如 代码 清单 5-20 所 示 。 
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代码 清单 5-20 listing11.go: 第 36 行 和 第 44 行 到 第 46 行 


36 lisa := &user{"Lisa", "lisa@email.com"} 























44 // 指向 user 类 型 值 的 指针 可 以 用 来 调用 
45 // 使 用 指针 接收 者 声明 的 方法 


46 lisa.changeEmail ("lisa@newdomain.com") 

在 代码 清单 5-20 中 ， 可 以 看 到 声明 了 1isa 指针 变量 ， 还 有 第 46 行使 用 这 个 变量 调用 了 
changeEmail 方法 。 一旦 changeEmail 调用 返回 ， 这 个 调用 对 值 做 的 修改 也 会 反映 在 1isa 
此 针 所 指向 的 值 上 。 这 是 因为 changeEmail 方法 使 用 了 指针 接收 者 。 总 结 一 下 , 值 接收 者 使 用 
值 的 副本 来 调用 方法 ， 而 指针 接受 者 使 用 实际 值 来 调用 方法 。 

也 可 以 使 用 一 个 值 来 调用 使 用 指针 接收 者 声明 的 方法 ， 如 代码 清单 5-21 所 示 。 






































代码 清单 5-21 listing11.go: 第 31 行 和 第 39 行 到 第 41 行 


Sy bill := user{"Bill", "billQemail.com"} 














39 // user 类 型 的 值 可 以 用 来 调用 
40 // 使 用 指针 接收 者 声明 的 方法 


41 bill.changeEmail ("bill@newdomain.com") 

在 代码 清单 5-21 中 可 以 看 到 声明 的 变量 bi11, 以 及 之 后 使 用 这 个 变量 调用 使 用 指针 接收 者 
声明 的 changeEmail 方法 。Go 语言 再 一 次 对 值 做 了 调整 , 使 之 符合 函数 的 接收 者 , 进行 调用 ， 
如 代码 清单 5-22 所 示 。 









































代码 清单 5-22 ”Go 在 代码 背后 的 执行 动作 


(&bill) .changeEmail ("bill@newdomain.com") 





代码 清单 5-22 展示 了 Go 编译 器 为 了 支持 这 种 方法 调用 在 背后 做 的 事情 。 在 这 个 例子 里 , 首 
先 引 用 bill 值得 到 一 个 指针 ， 这 样 这 个 指针 就 能 够 匹配 方法 的 接收 者 类 型 ， 再 进行 调用 。Go 
语言 既 允 许 使 用 值 ， 也 人 允许 使 用 指针 来 调用 方法 ,不 必 严 格 符合 接收 者 的 类 型 。 这 个 支持 非常 方 
便 开发 者 编写 程序 。 

应 该 使 用 值 接收 者 ， 还 是 应 该 使 用 指针 接收 者 ， 这 个 问题 有 时 会 比较 迷惑 人 。 可 以 遵从 标准 
库 里 一 些 基本 的 指导 方针 来 做 决定 。 后 面 会 进一步 介绍 这 些 指导 方针 。 





5.3 ”类 型 的 本 质 


在 声明 一 个 新 类 型 之 后 ,声明 一 个 该 类 型 的 方法 之 前 , 需要 先 回 答 一 个 问题 ; 这 个 类 型 的 本 
质 是 什么 。 如 果 给 这 个 类 型 增加 或 者 删除 某 个 值 ， 是 要 创建 一 个 新 值 , 还 是 要 更 改 当 前 的 值 ? 如 
果 是 要 创建 一 个 新 值 , 该 类 型 的 方法 就 使 用 值 接收 者 。 如 果 是 要 修改 当前 值 , 就 使 用 指针 接收 者 。 
这 个 答案 也 会 影响 程序 内 部 传递 这 个 类 型 的 值 的 方式 : 是 按 值 做 传递 ,还 是 按 指针 做 传递 。 保持 











传递 的 一 致 性 很 重要 。 这 个 背后 的 原则 是 ,不 要 只 关注 某 个 方法 是 如 何 处 理 这 个 值 ， 而 是 要 关注 
这 个 值 的 本 质 是 什么 。 


5.3.1 ”内置 类 型 


内 置 类 型 是 由 语言 提供 的 一 组 类 型 。 我 们 已 经 见 过 这 些 类 型 ， 分 别 是 数值 类 型 、 字 符 串 类 型 
和 布尔 类 型 。 这 些 类 型 本 质 上 是 原始 的 类 型 。 因 此 ， 当 对 这 些 值 进行 增加 或 者 删除 的 时 候 ， 会 创 
建 一 个 新 值 。 基 于 这 个 结论 ， 当 把 这 些 类 型 的 值 传递 给 方法 或 者 函数 时 ,应 该 传递 一 个 对 应 值 的 
副本 。 让 我 们 看 一 下 标准 库 里 使 用 这 些 内 置 类 型 的 值 的 函数 ， 如 代码 清单 5-23 所 示 。 

















代码 清单 5-23 golang.org/src/strings/strings.go: 第 620 行 到 第 625 行 


620 func Trim(s string, cutset string) string { 


621 if s == "" || cutset == "™™ { 

622 return s 

623 } 

624 return TrimFunc(s, makeCutsetFunc (cutset) ) 
625 } 


在 代码 清单 5-23 中 ， 可 以 看 到 标准 库 里 strings 包 的 Trim 函数 。Trim 子 数 传人 一 个 
string 类 型 的 值 作 操作 ， 再 传人 一 个 string 类 型 的 值 用 于 查找 。 之 后 函数 会 返回 一 个 新 的 
string 值 作为 操作 结果 。 这 个 函数 对 调用 者 原始 的 string 值 的 一 个 副本 做 操作 , 并 返回 一 个 
新 的 string 值 的 副本 。 字 符 串 〈 string ) 就 像 整 数 、 浮 点 数 和 布尔 值 一 样 ， 本 质 上 是 一 种 很 原 
始 的 数据 值 ， 所 以 在 函数 或 方法 内 外 传递 时 ， 要 传递 字符 串 的 一 份 副本 。 

让 我 们 看 一 下 体现 内 置 类 型 具有 的 原始 本 质 的 第 二 个 例子 ， 如 代码 清单 5-24 所 示 。 





代码 清单 5-24 golang.org/src/os/env.go: 第 38 行 到 第 44 行 


38 func isShellSpecialVar(c uint8) bool { 


39 Switch c { 

40 cease Tr VET BO vl TO irs VOT dT on 
'6" I 38! OR 

41 return true 

42 } 

43 return false 

44 } 


代码 清单 5-24 展示 了 env 包 里 的 isShe11SpecialVaz 图 数 。 这 个 国 数 传人 了 一 个 int8 
类 型 的 值 ， 并 返回 一 个 bool 类 型 的 值 。 注 意 ,， 这 里 的 参数 没有 使 用 指针 来 共享 参数 的 值 或 者 返 
回 值 。 调 用 者 传人 了 一 个 uint8 值 的 副本 ， 并 接受 一 个 返回 值 true 或 者 false。 
5.3.2 引用 类 型 

Go 语言 里 的 引用 类 型 有 如 下 几 个 : 切片 、 上 映射、 通道 、 接 口 和 函数 类 型 。 当 声明 上 述 类 型 





的 变量 时 ,创建 的 变量 被 称 作 标 头 ( header ) 值 。 从 技术 细节 上 说 ， 字 符 串 也 是 一 种 引用 类 型 。 
每 个 引用 类 型 创建 的 标 头 值 是 包含 一 个 指向 底层 数据 结构 的 指针 。 每 个 引用 类 型 还 包含 一 组 独特 
的 字段 , 用 于 管理 底层 数据 结构 。 因 为 标 头 值 是 为 复制 而 设计 的 ,所 以 永远 不 需要 共享 一 个 引用 
类 型 的 值 。 标 头 值 里 包含 一 个 指针 ,， 因 此 通过 复制 来 传递 一 个 引用 类 型 的 值 的 副本 ,本质 上 就 是 
在 共享 底层 数据 结构 。 

让 我 们 看 一 下 net 包 里 的 类 型 ， 如 代码 清单 5-25 所 示 。 








代码 清单 5-25 ”golang.org/src/net/ip.go: 第 32 行 
32 type IP []byte 


代码 清单 5-25 展示 了 一 个 名 为 IP 的 类 型 , 这 个 类 型 被 声明 为 字 节 切片 。 当 要 围绕 相关 的 内 





置 类 型 或 者 引用 类 型 来 声明 用 户 定义 的 行为 时 , 直接 基于 已 有 类 型 来 声明 用 户 定义 的 类 型 会 很 好 
用 。 编 译 器 只 允许 为 命名 的 用 户 定义 的 类 型 声明 方法 ， 如 代码 清单 5-26 所 示 。 





代码 清单 5-26 ”golang.org/src/net/ip.go: 第 329 行 到 第 337 行 


329 func (ip IP) MarshalText () ([]byte, error) { 

330 if len(ip) == 0 { 

号 3 下 return []byte("")，nil 

332 } 

333 if len(ip) != IPv4len && len(ip) != IPv6len { 
334 return nil, errors.New("invalid IP address") 
335 } 

336 return []byte(ip.String()), nil 

337 } 





代码 清单 5-26 里 定义 的 MarshalText 方法 是 用 IP 类 型 的 值 接 收 者 声明 的 ,一 个 值 接收 者 ， 
正 像 预期 的 那样 通过 复制 来 传递 引用 , 从 而 不 需要 通过 指针 来 共享 引用 类 型 的 值 。 这 种 传递 方法 
也 可 以 应 用 到 函数 或 者 方法 的 参数 传递 ， 如 代码 清单 5-27 所 示 。 


代码 清单 5-27 golang.org/src/net/ip.go: 第 318 行 到 第 325 行 





318 // ipEmptyString 像 ip.string 一样 ， 
319 // 只 不 过 在 没有 设置 ip 时 会 返回 一 个 空 字 符 串 
320 func ipEmptyString(ip IP) string { 

















32. if len(ip) == 0 { 
2 return "" 

323 } 

324 return ip.String() 
325 3} 


在 代码 清单 5-27 里 ， 有 一 个 ipEmptyString 函数 。 这 个 函数 需要 传人 一 个 IP 类 型 的 值 。 
再 一 次 , 你 可 以 看 到 调用 者 传人 的 是 这 个 引用 类 型 的 值 ， 而 不 是 通过 引用 共享 给 这 个 函数 。 调 用 
者 将 引用 类 型 的 值 的 副本 传 入 这 个 函数 。 这 种 方法 也 适用 于 函数 的 返回 值 。 最 后 要 说 的 是 , 引用 
类 型 的 值 在 其 他 方面 像 原始 的 数据 类 型 的 值 一 样 对 待 。 


5.3.3 ”结构 类 型 


结构 类 型 可 以 用 来 描述 一 组 数据 值 ,这 组 值 的 本 质 即 可 以 是 原始 的 , 也 可 以 是 非 原 始 的 。 如 
果 决 定 在 某 些 东 西 需要 删除 或 者 添加 某 个 结构 类 型 的 值 时 该 结构 类 型 的 值 不 应 该 被 更 改 , 那么 需 
要 遵守 之 前 提 到 的 内 置 类 型 和 引用 类 型 的 规范 。 让 我 们 从 标准 库 里 的 一 个 原始 本 质 的 类 型 的 结构 
实现 开始 ， 如 代码 清单 5-28 所 示 。 














代码 清单 5-28 ”golang.org/src/time/time.go: 第 39 行 到 第 55 行 


39 type Time struct { 


























40 // sec 给 出 自 公 元 1 年 1 月 1 日 00:00:00 
41 // 开始 的 秒 数 

42 sec int64 

43 


44 // nsec 指定 了 一 秒 内 的 纳 秒 偏 移 ， 
45 // 这 个 值 是 非 零 值 ， 














46 // 必须 在 [0，999999999] 范 围 内 

47 nsec int32 

48 

49 // loc 指定 了 一 个 Location， 

50 // 用 于 决定 该 时 间 对 应 的 当地 的 分 、 小 时 、 
51 // 天 和 年 的 值 























52 // 只 有 Time 的 零 值 ， 其 1oc 的 值 是 nil 
53 // 这 种 情况 下 ， 认 为 处 于 UTC 时 区 

54 loc *Location 

55: 


代码 清单 5-28 中 的 Time 结构 选 自 time 包 。 当 思考 时 间 的 值 时 , 你 应 该 意识 到 给 定 的 一 个 
时 间 点 的 时 间 是 不 能 修改 的 。 所 以 标准 库 里 也 是 这 样 实现 Time 类 型 的 。 让 我 们 看 一 下 Now 函 
数 是 如 何 创建 Time 类 型 的 值 的 ， 如 代码 清单 5-29 所 示 。 





代码 清单 5-29 ”golang.org/src/time/time.go: 第 781 行 到 第 784 行 


781 func Now() Time { 


782 sec nsec := now() 
783 return Time{sec + unixToInternal, nsec, Local} 
784 } 


代码 清单 5-29 中 的 代码 展示 了 Now 函数 的 实现 。 这 个 函数 创建 了 一 个 Time 类 型 的 值 ， 并 
给 调用 者 返回 了 Time 值 的 副本 。 这 个 函数 没有 使 用 指针 来 共享 Time 值 。 之 后 ， 让 我 们 来 看 一 
个 Time 类 型 的 方法 ， 如 代码 清单 5-30 所 示 。 


代码 清单 5-30 ”golang.org/src/time/time.go: 第 610 行 到 第 622 行 





610 func (t Time) Add(d Duration) Time { 
611 t.sec += int64(d / le9) 
612 nsec := int32(t.nsec) + int32(d%$le9) 


613 if nsec >= le9 { 


614 t.sectt+ 

615 nsec -= le9 

616 } else if nsec < 0 { 
617 = 

618 nsec += 1e9 

619 } 

620 t.nsec = nsec 

621 return 七 

622 } 


代码 清单 5-30 中 的 Adad 方法 是 展示 标准 库 如 何 将 Time 类 型 作为 本 质 是 原始 的 类 型 的 
绝 佳 例子 。 这 个 方法 使 用 值 接收 者 ， 并 返回 了 一 个 新 的 Time 值 。 该 方法 操作 的 是 调用 者 
传 和 的 Time 值 的 副本 , 并 且 给 调用 者 返回 了 一 个 方法 内 的 Time 值 的 副本 。 至 于 是 使 用 返 
回 的 值 替 换 原来 的 Time 值 , 还 是 创建 一 个 新 的 Time 变量 来 保存 结果 , 是 由 调用 者 决定 的 
事情 。 

大 多 数 情 况 下 ， 结 构 类 型 的 本 质 并 不 是 原始 的 ， 而 是 非 原始 的 。 这 种 情况 下 ， 对 这 个 类 型 的 
值 做 增加 或 者 删除 的 操作 应 该 更 改 值 本 身 。 当 需要 修改 值 本 身 时 , 在 程序 中 其 他 地 方 , 需要 使 用 

站 针 来 共享 这 个 值 。 让 我 们 看 一 个 由 标准 库 中 实现 的 具有 非 原始 本 质 的 结构 类 型 的 例子 , 如 代码 
清单 5-31 所 示 。 










































































代码 清单 5-31 golang.org/src/os/file_unix.go: 第 15 行 到 第 29 行 

















15 // File 表示 一 个 打开 的 文件 描述 符 

16 type File struct { 

17 *file 

18 } 

19 

20 // file 是 *File 的 实际 表示 

21 // 额外 的 一 层 结构 保证 没有 哪个 os 的 客户 端 
22 // 能 够 覆盖 这 些 数据 。 如 果 履 盖 这 些 数据 ， 
23 // 可 能 在 变量 终结 时 关闭 错误 的 文件 描述 符 
24 type file struct { 



































25 Ed A 

26 name string 

27 dirinfo *dirInfo // 除了 目录 结构 ， 此 字段 为 nil 
28 nepipe int32 // Write 操作 时 过 到 连续 EPIPE 的 次 数 
29 } 


可 以 在 代码 清单 5-31 里 看 到 标准 库 中 声明 的 File 类 型 。 这 个 类 型 的 本 质 是 非 原始 的 。 这 
个 类 型 的 值 实际 上 不 能 安全 复制 。 对 内 部 未 公开 的 类 型 的 注释 , 解释 了 不 安全 的 原因 。 因 为 没有 
方法 阻止 程序 员 进行 复制 ,所 以 File 类 型 的 实现 使 用 了 一 个 嵌入 的 指针 ， 指 向 一 个 未 公开 的 类 
型 。 本 章 后 面 会 继续 探讨 内 嵌 类 型 。 正 是 这 层 额 外 的 内 榜 类 型 阻止 了 复制 。 不 是 所 有 的 结构 类 型 
都 需要 或 者 应 该 实现 类 似 的 额外 保护 。 程序 员 需 要 能 识别 出 每 个 类 型 的 本 质 , 并 使 用 这 个 本 质 来 
决定 如 何 组 织 类 型 。 

让 我 们 看 一 下 open 函数 的 实现 ， 如 代码 清单 5-32 所 示 。 














代码 清单 5-32 golang.org/src/os/file.go: 第 238 行 到 第 240 行 


238 func Open (name string) (file *File, err error) { 
239 return OpenFile (name, O RDONLY, 0) 


代码 清单 5-32 展示 了 open 函数 的 实现 ， 调 用 者 得 到 的 是 一 个 指向 File 类 型 值 的 指针 。 
Open 创建 了 File 类 型 的 值 ， 并 返回 指向 这 个 值 的 指针 。 如 果 一 个 创建 用 的 工厂 函数 返回 了 一 
个 指针 ， 就 表示 这 个 被 返回 的 值 的 本 质 是 非 原始 的 。 

即便 函数 或 者 方法 没有 直接 改变 非 原始 的 值 的 状态 , 依旧 应 该 使 用 共享 的 方式 传递 , 如 代码 
清单 5-33 所 示 。 








代码 清单 5-33 ”golang.org/src/os/file.go: 第 224 行 到 第 232 行 


224 func (f *File) Chdir() error { 


225 if f == nil { 

226 return Errinvalid 

227 } 

228 if e := syscall.Fchdir(f.fd); e != nil { 
2 return &PathError{"chdir", f.name, el 
230 } 

之 3 于 return nil 

232 } 


代码 清单 5-33 中 的 chdir 方法 展示 了 ， 即 使 没有 修改 接收 者 的 值 ， 依 然 是 用 指针 接收 者 来 
声明 的 。 因 为 File 类 型 的 值 具备 非 原始 的 本 质 ， 所 以 总 是 应 该 被 共享 ， 而 不 是 被 复制 。 

是 使 用 值 接收 者 还 是 指针 接收 者 , 不 应 该 由 该 方法 是 否 修改 了 接收 到 的 值 来 决定 。 这 个 决策 
应 该 基于 该 类 型 的 本 质 。 这 条 规则 的 一 个 例外 是 , 需要 让 类 型 值 符合 某 个 接口 的 时 候 ， 即 便 类 型 
的 本 质 是 非 原 始 本 质 的 , 也 可 以 选择 使 用 值 接收 者 声明 方法 。 这样 做 完全 符合 接口 值 调用 方法 的 
机 制 。5.4 节 会 讲解 什么 是 接口 值 ， 以 及 使 用 接口 值 调 用 方法 的 机 制 。 














Xx 接口 


多 态 是 指 代码 可 以 根据 类 型 的 具体 实现 采取 不 同行 为 的 能 力 。 如 果 一 个 类 型 实现 了 某 个 接 
口 ， 所 有 使 用 这 个 接口 的 地 方 ， 都 可 以 支持 这 种 类 型 的 值 。 标 准 库 里 有 很 好 的 例子 ， 如 io 包 里 
实现 的 流 式 处 理 接口 。io 包 提 供 了 一 组 构造 得 非常 好 的 接口 和 函数 ， 来 让 代码 轻松 支持 流 式 数 
据 处 理 。 只 要 实现 两 个 接口 ， 就 能 利用 整个 ie 包 背 后 的 所 有 强大 能 力 。 

不 过 , 我 们 的 程序 在 声明 和 实现 接口 时 会 涉及 很 多 细节 。 即 便 实现 的 是 已 有 接口 ,也 需要 了 
解 这 些 接口 是 如 何 工 作 的 。 在 探究 接口 如 何 工 作 以 及 实现 的 细节 之 前 , 我 们 先 来 看 一 下 使 用 标准 
库 里 的 接口 的 例子 。 








5.4.1 


标准 库 


我 们 先 来 看 一 个 示例 程序 ， 这 个 程序 实现 了 流行 程序 curl 的 功能 ， 如 代码 清单 5-34 所 示 。 


代码 清单 5-34 listing34.go 





AD 


// 这 个 示例 程序 展示 如 何 使 用 io.Reader 和 io.writer 接 




















// 写 一 1 简单 版 本 的 pa 程序 


















































Package main 
Import ( 
"fmt" 
TY Re 
"net/http" 
TY os TY 
) 
// init 在 main 函数 之 前 调 
func init () { 
if len(os.Args) != 2 { 
fmt.Println("Usage: ./example2 <url>") 
os .Exit (—1) 
} 
} 
// main 是 应 用 程序 的 入 
func main() { 
// 从 Web 服务 器 得 到 响应 
r, err := http.Get (os.Args [1]) 
if err != nil { 
fmt .Println (err) 
return 
} 
// 从 Body 复制 到 st dout 
ioCopy(os:Stdoutr :rT.Body) 
if err := r.Body.Close(); err != nil { 
fmt .Println (err) 
} 
} 


代码 清单 5-34 展示 了 接口 的 能 力 以 及 在 标准 库 里 的 应 用 。 只 用 了 几 行 代码 我 们 就 通过 两 个 














函数 以 及 配套 的 接口 ， 完 成 了 curl 程序 。 在 第 23 行 ， 调 用 了 http 包 的 Get 函数 。 在 与 服务 器 
成 功 通 信 后 ，http .Get 困 数 会 返回 一 个 http.Response 类 型 的 指针 。http .Response 类 
型 包含 一 个 名 为 Body 的 字段 ， 这 个 字段 是 一 个 1o.Readcloser 接口 类 型 的 值 。 

在 第 30 行 ， Body 字段 作为 第 二 个 参数 传 给 io .Copy 函数 。io .Copy 函数 的 第 二 个 参数 ， 
接受 一 个 io .Reader 接口 类 型 的 值 ， 这 个 值 表示 数据 流入 的 源 。Body 字段 实现 了 io .Reader 


接口 ， 因 此 我 们 可 以 将 Body 字段 传人 io.Copy， 使 用 Web 服务 器 的 返回 内 容 作为 源 。 

io .Copy 的 第 一 个 参数 是 复制 到 的 目标 ， 这 个 参数 必须 是 一 个 实现 了 io .Write 接口 的 
值 。 对 于 这 个 目标 ,我们 传人 了 os 包 里 的 一 个 特殊 值 Stdout。 这 个 接口 值 表示 标准 输出 设备 ， 
并 且 已 经 实现 了 io.Writez 接口 。 当 我 们 将 Body 和 Stdout 这 两 个 值 传 给 io .Copy 函数 后 ， 
这 个 函数 会 把 服务 器 的 数据 分 成 小 段 ,源源 不 断 地 传 给 终端 窗口 ,直到 最 后 一 个 片段 读 取 并 写 入 
终端 ，io.Copy 函数 才 返 回 。 

io.Copy 函数 可 以 以 这 种 工作 流 的 方式 处 理 很 多 标准 库 里 已 有 的 类 型 ， 如 代码 清单 5-35 
所 示 。 


代码 清单 5-35 listing35.go 


01 // 这 个 示例 程序 展示 bytes .Buffer 也 可 以 
02 // 用 于 io.Copy 函数 
03 package main 






















































































04 

05 import ( 

06 "bytes" 

07 Fe 

08 ey 

09 vos 

10 ) 

本 

12 // main 是 应 用 程序 的 入 

13 func main() 

14 var b bytes.Buffer 

45 

16 // 将 字符 串 写 入 Buffer 

17 b.Write([]byte ("Hello")) 
18 

19 // 使 用 Fprintf 将 字符 串 拼 接 到 Buffer 
20 fmt.Fprintf(&b, "World!") 
多 和 

22 // 将 Buffer 的 内 容 写 到 stqdout 
23 io.Copy (os.Stdout, &b) 

24 } 


代码 清单 5-35 展示 了 一 个 程序 ， 这 个 程序 使 用 接口 来 拼接 字符 串 ， 并 将 数据 以 流 的 方式 输 
出 到 标准 输出 设备 。 在 第 14 行 ,创建 了 一 个 bytes 包 里 的 Buffer 类 型 的 变量 b, 用 于 缓冲 数 
据 。 之 后 在 第 17 行使 用 write 方法 将 字符 串 Hello 写 人 这 个 缓冲 区 b。 第 20 行 ， 调 用 fmt 
包 里 的 Fprintf 函数 ， 将 第 二 个 字符 串 追 加 到 缓冲 区 b 里 。 

fmt .Fprintf 困 数 接受 一 个 io.Writer 类 型 的 接口 值 作为 其 第 一 个 参数 。 由 于 
bytes .Buffer 类 型 的 指针 实现 了 io.Writer 接口 ， 所 以 可 以 将 缓存 b 传人 fmt .Fprintf 
函数 ， 并 执行 追加 操作 。 最 后 ,在 第 23 行 ， 再 次 使 用 io .Copy 函数 ， 将 字符 写 到 终端 窗口 。 
由 于 bytes .Buffer 类 型 的 指针 也 实现 了 io.Reader 接口 ,io.Copy 函数 可 以 用 于 在 终端 窗 





口 显示 缓冲 区 b 的 内 容 。 
希望 这 两 个 小 程序 展示 出 接口 的 好 处 ,以 及 标准 库 内 部 是 如 何 使 用 接口 的 。 下 一 步 , 让 我 们 
看 一 下 实现 接口 的 细节 。 











5.4.2 ”实现 




















接口 是 用 来 定义 行为 的 类 型 。 这 些 被 定义 的 行为 不 由 接口 直接 实现 ,而 是 通过 方法 由 用 户 
定义 的 类 型 实现 。 如 果 用 户 定 义 的 类 型 实现 了 某 个 接口 类 型 声明 的 一 组 方法 ,那么 这 个 用 户 定 
义 的 类 型 的 值 就 可 以 赋 给 这 个 接口 类 型 的 值 。 这 个 赋值 会 把 用 户 定义 的 类 型 的 值 存 入 接口 类 型 
的 值 。 

对 接口 值 方法 的 调用 会 执行 接口 值 里 存储 的 用 户 定义 的 类 型 的 值 对 应 的 方法 。 因 为 任何 用 户 
定义 的 类 型 都 可 以 实现 任何 接口 ， 所 以 对 接口 值 方法 的 调用 自然 就 是 一 种 多 态 。 在 这 个 关系 里 ， 
用 户 定义 的 类 型 通常 叫 作 实 体 类 型 ,原因 是 如 果 离 开 内 部 存储 的 用 户 定义 的 类 型 的 值 的 实现 , 接 
口 值 并 没有 具体 的 行为 。 

并 不 是 所 有 值 都 完全 等 同 , 用 户 定义 的 类 型 的 值 或 者 指针 要 满足 接口 的 实现 , 需要 遵守 一 些 
规则 。 这 些 规则 在 5.4.3 节 介 绍 方 法 集 时 有 详细 说 明 。 探 寻 方 法 集 的 细节 之 前 ， 了 解 接口 类 型 值 
大 概 的 形式 以 及 用 户 定义 的 类 型 的 值 是 如 何 存 入 接口 的 ， 会 有 很 多 帮助 。 

图 5-1 展示 了 在 user 类 型 值 赋值 后 接口 变量 的 值 的 内 部 布局 。 接 口 值 是 一 个 两 个 字 长 度 
的 数据 结构 ， 第 一 个 字 包 含 一 个 指向 内 部 表 的 指针 。 这 个 内 部 表 叫 作 iTable， 包 含 了 所 存储 的 
值 的 类 型 信息 。iTable 包含 了 已 存储 的 值 的 类 型 信息 以 及 与 这 个 值 相 关联 的 一 组 方法 。 第 二 个 
字 是 一 个 指向 所 存储 值 的 指针 。 将 类 型 信息 和 指针 组 合 在 一 起 ， 就 将 这 两 个 值 组 成 了 一 种 特殊 
的 关系 。 




















































































































tif var n notifier 
notifier nPi 
n = user{"Bill"} 
接口 值 iTable 


iTable 
的 地 址 
存储 的 值 


User 














图 5-1 实体 值 赋值 后 接口 值 的 简 图 

















图 5-2 展示 了 一 个 指针 赋值 给 接口 之 后 发 生 的 变化 。 在 这 种 情况 里 ， 类 型 信息 会 存储 一 个 指 
向 保存 的 类 型 的 指针 ， 而 接口 值 第 二 个 字 依旧 保存 指向 实体 值 的 指针 。 


5.4.3 





Var n notifier 


notifier n = &user{"Bill")} 


接口 值 iTable 











时 


图 5-2 实体 指针 赋值 后 接口 值 的 简 图 











方法 集 








方法 集 定义 了 接口 的 接受 规则 。 看 一 下 代码 清单 5-36 所 示 的 代码 ， 有 助 于 理解 方法 集 在 接 
口中 的 重要 角色 。 


代码 清单 5-36 listing36.go 





01 
02 
03 
04 
05 
06 
07 
08 
09 
10 





29 











// 这 个 示例 程序 展示 Go 语言 里 如 何 使 用 接 


Package main 











import ( 
mm fmt TY 
) 


// notifier 是 一 个 定义 了 

// 通知 类 行为 的 接口 

type notifier interface { 
notify () 














} 











// user 在 程序 里 定义 一 个 用 户 类 型 
type user struct { 

name string 

email string 














} 





// notify 是 使 用 指针 接收 者 实现 的 方法 


func (u *user) notify() { 
fmt.Printf("Sending user email to %s<%s>\n", 
u.name, 
u.email) 


} 














// main 是 应 用 程序 的 入 
func main() { 


// 创建 一 个 user 类 型 的 值 ， 并 发 送 通知 























30 u := user{"Bill", "bill@email.com"} 





31 

32 sendNotification (u) 

33 

34 // ./listing36.go:32: 不 能 将 u( 类 型 是 user) 作为 

35 // sendNotification 的 参数 类 型 notifier: 
36 // user 类 型 并 没有 实现 notifier 

37 // (notify 方法 使 用 指针 接收 者 声明 ) 
38 } 

39 


40 // sendNotification 接受 一 个 实现 了 notifier 接口 的 值 
41 // 并 发 送 通知 

42 func sendNotification(n notifier) { 

43 n.notify() 

44 } 


代码 清单 5-36 中 的 程序 虽然 看 起 来 没 问题 ， 但 实际 上 却 无 法 通过 编译 。 在 第 10 行 中 ,声明 
了 一 个 名 为 notifier 的 接口 ， 包 含 一 个 名 为 notify 的 方法 。 第 15 行 中 ， 声 明了 名 为 user 
的 实体 类 型 ， 并 通过 第 21 行 中 的 方法 声明 实现 了 notifier 接口 。 这 个 方法 是 使 用 user 类 型 
的 指针 接收 者 实现 的 。 














代码 清单 5-37 listing36.go: 第 40 行 到 第 44 行 





40 // sendqNotification 接受 一 个 实现 了 notifier 接口 的 值 
41 // 并 发 送 通 知 

42 func sendNotification(n notifier) { 

43 n.notify() 

44 } 


在 代码 清单 5-37 的 第 42 行 , 声明 了 一 个 名 为 sendNotification 的 函数 。 这 个 函数 接收 
一 个 notifier 接口 类 型 的 值 。 之 后 ,使 用 这 个 接口 值 来 调用 notify 方法 。 任 何 一 个 实现 了 
notifier 接口 的 值 都 可 以 传人 sendNotification 国 数 。 现 在 让 我 们 来 看 一 下 main 子 数 ， 
如 代码 清单 5-38 所 示 。 

















代码 清单 5-38 listing36.go: 第 28 行 到 第 38 行 









































28 func main() { 

29 // 创建 一 个 user 类 型 的 值 ， 并 发 送 通知 

30 u := user{"Bill", "bill@email.com"} 

3 下 

32 sendNotification (u) 

33 

34 // ./listing36.go:32: 不 能 将 u( 类 型 是 user) 作为 

35 // sendNotification 的 参数 类 型 notifier: 
36 // user 类 型 并 没有 实现 notifier 

37 // (notify 方法 使 用 指针 接收 者 声明 ) 
38 -小 


在 main 函数 里 ,代码 清单 5-38 的 第 30 行 , 创建 了 一 个 user 实体 类 型 的 值 ， 并 将 其 赋值 给 变 
量 u。 之 后 在 第 32 行将 u 的 值 传人 sendNotification 困 数 。 不 过 ， 调 用 sendNotification 


的 结果 是 产生 了 一 个 编译 错误 ， 如 代码 清单 5-39 所 示 。 


代码 清单 5-39 将 usezr 类 型 的 值 存 入 接口 值 时 产生 的 编译 错误 





./Listing36.go:32: 不 能 将 u (类 型 是 user) 作为 sendNotification 的 参数 类 型 notifier: 
user 类 型 并 没有 实现 notifier (notify 方法 使 用 指针 接收 者 声明 ) 


既然 user 类 型 已 经 在 第 21 行 实现 了 notify 方法 ， 为 什么 这 里 还 是 产生 了 编译 错误 呢 ? 
让 我 们 再 来 看 一 下 那 段 代码 ， 如 代码 清单 5-40 所 示 。 





代码 清单 5-40 listing36.go: 第 08 行 到 第 12 行 ， 第 21 行 到 第 25 行 
08 // notifier 是 一 个 定义 了 





09 // 通知 类 行为 的 接口 

10 type notifier interface { 
1 notify() 

站 儿 二 











21 func (u *user) notify() { 


2 fmt.Printf("Sending user email to %s<%s>\n", 
23 u.name, 

24 u.email) 

5 


代码 清单 5-40 展示 了 接口 是 如 何 实现 的 , 而 编译 器 告诉 我 们 user 类 型 的 值 并 没有 实现 这 
个 接口 。 如 果 仔 细 看 一 下 编译 带 输 出 的 消息 ， 其 实 编译 避 已 经 说 明了 原因 ， 如 代码 清单 5-41 
所 示 。 





代码 清单 5-41 进一步 查看 编译 器 错误 
(notify method has pointer receiver) 
要 了 解 用 指针 接收 者 来 实现 接口 时 为 什么 user 类 型 的 值 无 法 实现 该 接口 , 需要 先 了 解 方 法 
集 。 方法 集 定义 了 一 组 关联 到 给 定 类 型 的 值 或 者 指针 的 方法 。 定义 方法 时 使 用 的 接收 者 的 类 型 决 
定 了 这 个 方法 是 关联 到 值 ， 还 是 关联 到 指针 ， 还 是 两 个 都 关联 。 
让 我 们 先 解释 一 下 Go 语言 规范 里 定义 的 方法 集 的 规则 ， 如 代码 清单 5-42 所 示 。 








代码 清单 5-42 ”规范 里 描述 的 方法 集 


Values Methods Receivers 
(Ear) 
*T CA 


代码 清单 5-42 展示 了 规范 里 对 方法 集 的 描述 。 描 述 中 说 到 ，T 类 型 的 值 的 方法 集 只 包含 值 
接收 者 声明 的 方法 。 而 指向 T 类 型 的 指针 的 方法 集 既 包含 值 接收 者 声明 的 方法 , 也 包含 指针 接收 
者 声明 的 方法 。 从 值 的 角度 看 这 些 规则 , 会 显得 很 复杂 。 让 我 们 从 接收 者 的 角度 来 看 一 下 这 些 规 
则 ， 如 代码 清单 5-43 所 示 。 


代码 清单 5-43 ”从 接收 者 类 型 的 角度 来 看 方法 集 





Methods Receivers Values 
(tT) T and *T 
CE Ey} 次 于 


代码 清单 5-43 展示 了 同样 的 规则 ， 只 不 过 换 成 了 接收 者 的 视角 。 这 个 规则 说 ， 如 果 使 用 指 
针 接 收 者 来 实现 一 个 接口 ， 那 么 只 有 指向 那个 类 型 的 指针 才能 够 实现 对 应 的 接口 。 如 果 使 用 值 
接收 者 来 实现 一 个 接口 ， 那 么 那个 类 型 的 值 和 指针 都 能 够 实现 对 应 的 接口 。 现 在 再 看 一 下 代码 
清单 5-36 所 示 的 代码 ， 就 能 理解 出 现 编译 错误 的 原因 了 ， 如 代码 清单 5-44 所 示 。 





代码 清单 5-44 listing36.go: 第 28 行 到 第 38 行 




















28 func main() { 

29 // 使 用 user 类 型 创建 一 个 值 ， 并 发 送 通知 

世间 u := user{"Bill", "bill@email.com"} 

31 

号 和 SenqNotification(u) 

33 

34 // ./listing36.go:32: 不 能 将 u( 类 型 是 user) 作为 

35 // sendNotification 的 参数 类 型 notifier: 
36 // user 类 型 并 没有 实现 notifier 

37 // (notify 方法 使 用 指针 接收 者 声明 ) 
3 





我 们 使 用 指针 接收 者 实现 了 接口 ， 但 是 试图 将 user 类 型 的 值 传 给 senqNotification 方 
法 。 代 码 清单 5-44 的 第 30 行 和 第 32 行 清晰 地 展示 了 这 个 问题 。 但 是 ， 如 果 传 递 的 是 user 值 
的 地 址 ， 整 个 程序 就 能 通过 编译 ， 并 且 能 够 工作 了 ， 如 代码 清单 5-45 所 示 。 





代码 清单 5-45 listing36.go: 第 28 行 到 第 35 行 



































28 func main() { 

29 // 使 用 user 类 型 创建 一 个 值 ， 并 发 送 通知 

二 六 u := user{"Bill", "bill@email.com"} 
31 

32 sendNotification(&u) 

33 

34 // 传 入 地 址 ， 不 再 有 错误 

3 


在 代码 清单 5-45 里 ， 这 个 程序 终于 可 以 编译 并 且 运 行 。 因 为 使 用 指针 接收 者 实现 的 接口 ， 
只 有 user 类 型 的 指针 可 以 传 给 sendNotification 困 数 。 

现在 的 问题 是 ， 为 什么 会 有 这 种 限制 ? 事实 上 ， 编 译 器 并 不 是 总 能 自动 获得 一 个 值 的 地 址 ， 
如 代码 清单 5-46 所 示 。 


代码 清单 5-46 listing46.go 


01 // 这 个 示例 程序 展示 不 是 总 能 
02 // 获取 值 的 地 址 





03 Package main 


05 -Lmport. fmt" 














07 // quration 是 一 个 基于 int 类 型 的 类 型 
08 type duration int 





10 // 使 用 更 可 读 的 方式 格式 化 suration 值 
11 func (d *duration) pretty() string { 





























E> return fmt.Sprintf("Duration: %d", *d) 

13."} 

14 

15 // main 是 应 用 程序 的 入 

16 func main() { 

17 duration(42) .pretty () 

18 

19 // ./listing46.go:17: 不 能 通过 指针 调用 quration (42) 的 方法 
20 // ./listing46.go:17: 不 能 获取 duration (42) 的 地 址 

一 


代码 清单 5-46 所 示 的 代码 试图 获取 duration 类 型 的 值 的 地 址 , 但 是 获取 不 到 。 这 展示 了 不 能 
总 是 获得 值 的 地 址 的 一 种 情况 。 让 我 们 再 看 一 下 方法 集 的 规则 ， 如 代码 清单 5-47 所 示 。 





代码 清单 5-47 再 看 一 下 方法 集 的 规则 


Values Methods Receivers 
T (t TI) 
*T tt T'ang (t, *T} 
Methods Receivers Values 
tt TT Tartd *T 
《本 本 工 ) 类 眼 


因为 不 是 总 能 获取 一 个 值 的 地 址 ， 所 以 值 的 方法 集 只 包括 了 使 用 值 接收 者 实现 的 方法 。 


5.4.4 多 态 
现在 了 解 了 接口 和 方法 集 背 后 的 机 制 , 最 后 来 看 一 个 展示 接口 的 多 态 行为 的 例子 , 如 代码 清 
单 5-48 所 示 。 


代码 清单 5-48 listing48.go 
01 // 这 个 示例 程序 使 用 接口 展示 多 态 行为 


02 Package main 




















03 

04 import ( 
05 Em 
06 ) 


08 // notifier 是 一 个 定义 了 
09 // 通知 类 行为 的 接 
10 type notifier interface { 
notify() 


























} 























2 

3 

4 // user 在 程序 里 定义 一 个 用 户 类 型 
15 type user struct { 

6 

人 

8 

















name string 
email string 


} 



































20 // notify 使 用 指针 接收 者 实现 了 notifier 接 
21 func (u *user) notify() { 


2 fmt.Printf("Sending user email to %s<%s>\n", 
23 u.name, 

24 u.email) 

25. } 

26 

















27 // aqmin 定义 了 程序 里 的 管理 员 
28 type admin struct { 





Hm 




















29 name string 

30 email string 

3 导 中 

32 

33 // notify 使 用 指针 接收 者 实现 了 notifier 接 














34 func (a *admin) notify() { 







































































35 fmt.Printf("Sending admin email to %s<%s>\n", 
36 a.name, 

$7 a.email) 

38 1} 

39 

40 // main 是 应 用 程序 的 入 

41 func main() { 

42 // 创建 一 个 user 值 并 传 给 sendNotification 
43 bill := user{"Bill", "billQ@email.com"} 
44 sendNotification(&bill) 

45 

46 // 创建 一 个 admin 值 并 传 给 sendNotification 
47 lisa := admin{"Lisa", "lisa@email.com"} 
48 sendNotification(&lisa) 

49 } 

50 

51 // sendNotification 接受 一 个 实现 了 了 notifier 接口 的 值 
52 // 并 发 送 通知 

53 func senqNotification(n notifier) { 

54 n.notify() 

355 





在 代码 清单 5-48 中 ,我 们 有 了 一 个 展示 接口 的 多 态 行 为 的 例子 。 在 第 10 行 ， 我 们 声明 了 和 
之 前 代码 清单 中 一 样 的 notifier 接口 。 之 后 第 15 行 到 第 25 行 ， 我 们 声明 了 一 个 名 为 user 
的 结构 ， 并 使 用 指针 接收 者 实现 了 notifier 接口 。 在 第 28 行 到 第 38 行 ， 我 们 声明 了 一 个 名 








为 admin 的 结构 ， 用 同样 的 形式 实现 了 notifier 接口 。 现 在 ， 有 两 个 实体 类 型 实现 了 
notifier 接口 。 

在 第 53 行 中 ， 我 们 再 次 声明 了 多 态 函 数 senqNotification， 这 个 函数 接受 一 个 实现 了 
notifier 接口 的 值 作为 参数 。 既 然 任意 一 个 实体 类 型 都 能 实现 该 接口 ,那么 这 个 函数 可 以 针 
对 任意 实体 类 型 的 值 来 执行 notifier 方法 。 因此, 这 个 函数 就 能 提供 多 态 的 行为 ,如 代码 清 
单 5-49 所 示 。 








代码 清单 5-49 listing48.go: 第 40 行 到 第 49 行 











40 // main 是 应 用 程序 的 入 

















41 func main() { 

42 // 创建 一 个 user 值 并 传 给 sendNotification 

43 bill := user{"Bill", "billQ@email.com"} 

44 sendNotification(&bill) 

45 

46 // 创建 一 个 admin 值 并 传 给 sendNotification 
47 lisa := admin{"Lisa", "lisal@email.com"} 
48 sendNotification(&lisa) 

49 } 


最 后 ， 可 以 在 代码 清单 5-49 中 看 到 这 种 多 态 的 行为 。main 函数 的 第 43 行 创建 了 一 个 user 
类 型 的 值 ， 并 在 第 44 行将 该 值 的 地 址 传 给 了 sendNotification 函数 。 这 最 终 会 导致 执行 user 
类 型 声明 的 notify 方法 。 之 后 ， 在 第 47 行 和 第 48 行 ， 我 们 对 aqdmin 类 型 的 值 做 了 同样 的 事 
情 。 最 终 ， 因 为 sendNotification 接受 notifier 类 型 的 接口 值 ， 所 以 这 个 函数 可 以 同时 
执行 user 和 admin 实现 的 行为 。 








XX 嵌入 类 型 


Go 语言 允许 用 户 扩展 或 者 修改 已 有 类 型 的 行为 。 这 个 功能 对 代码 复 用 很 重要 ， 在 修改 已 有 
类 型 以 符合 新 类 型 的 时 候 也 很 重要 。 这 个 功能 是 通过 嵌入 类 型 (type embedding ) 完成 的 。 网 入 类 
型 是 将 已 有 的 类 型 直接 声明 在 新 的 结构 类 型 里 。 被 嵌入 的 类 型 被 称 为 新 的 外 部 类 型 的 内 部 类 型 。 

通过 般 入 类 型 , 与 内 部 类 型 相关 的 标识 符 会 提升 到 外 部 类 型 上 。 这 些 被 提升 的 标识 符 就 像 直 
接 声明 在 外 部 类 型 里 的 标识 符 一 样 , 也 是 外 部 类 型 的 一 部 分 。 这 样 外 部 类 型 就 组 合 了 内 部 类 型 包 
含 的 所 有 属性 , 并 且 可 以 添加 新 的 字段 和 方法 。 外 部 类 型 也 可 以 通过 声明 与 内 部 类 型 标识 符 同 名 
的 标识 符 来 覆盖 内 部 标识 符 的 字段 或 者 方法 。 这 就 是 扩展 或 者 修改 已 有 类 型 的 方法 。 

让 我 们 通过 一 个 示例 程序 来 演示 藤 入 类 型 的 基本 用 法 ， 如 代码 清单 5-50 所 示 。 


代码 清单 5-50 listing50.go 
01 // 这 个 示例 程序 展示 如 何 将 一 个 类 型 钥 入 男 一 个 类 型 ， 以 及 
02 // 内 部 类 型 和 外 部 类 型 之 间 的 关系 


03 package main 














05 import ( 
06 Ei 
07 ) 

08 











09 // user 在 程序 里 定义 一 个 用 户 类 型 
10 type user struct { 

name string 

email string 














} 





























2 
3 
14 
15 // notify 实现 了 一 个 可 以 通过 user 类 型 值 的 指针 
6 
学 
8 





// 调用 的 方法 
func (u *user) notify() { 
fmt.Printf("Sending user email to %s<%s>\n", 
19 u.name, 
20 u.email) 
21 } 
22 





23 // admin 代表 一 个 拥有 权限 的 管理 员 用 户 
24 type admin struct { 






































25 user // 嵌入 类 型 

26 level string 

27 } 

28 

29 // main 是 应 用 程序 的 入 

30 func main() { 

31 // 创建 一 个 admin 用 户 

32 ad := admint 

33 user: usert{ 

34 name: "john smith", 
35 email: "john@yahoo.com", 
36 }, 

37 level: “super", 

38 } 

39 

40 // 我 们 可 以 直接 访问 内 部 类 型 的 方法 
41 ad.user.notify() 

42 

43 // 内 部 类 型 的 方法 也 被 提升 到 外 部 类 型 
44 adq.notify() 

45 } 


在 代码 清单 5-50 中 ， 我 们 的 程序 演示 了 如 何 散 入 一 个 类 型 ， 并 访问 仍 和 人 类 型 的 标识 符 。 我 
们 从 第 10 行 和 第 24 行 中 的 两 个 结构 类 型 的 声明 开始 ， 如 代码 清单 5-51 所 示 。 








代码 清单 5-51 listing50.go: 第 09 行 到 第 13 行 ， 第 23 行 到 第 27 行 








09 // user 在 程序 里 定义 一 个 用 户 类 型 
10 type user struct { 

站 入 name string 

12 email string 

下 








23 // aqmin 代表 一 个 拥有 权限 的 管理 员 用 户 
24 type admin struct { 








25 user // 骨 入 类 型 
26 level string 
之 人 十 


在 代码 清单 5-51 的 第 10 行 ， 我 们 声明 了 一 个 名 为 user 的 结构 类 型 。 在 第 24 行 ， 我 们 声 
明了 男 一 个 名 为 admin 的 结构 类 型 。 在 声明 admin 类 型 的 第 25 行 , 我 们 将 user 类 型 脱 入 admin 
类 型 里 。 要 骨 入 一 个 类 型 ， 只 需要 声明 这 个 类 型 的 名 字 就 可 以 了 。 在 第 26 行 ， 我们 声明 了 一 个 
名 为 level 的 字段 。 注 意 声明 字段 和 衣 人 类 型 在 语法 上 的 不 同 。 

一 旦 我 们 将 user 类 型 脱 入 aqmin， 我 们 就 可 以 说 user 是 外 部 类 型 admin 的 内 部 类 型 。 
有 了 内 部 类 型 和 外 部 类 型 这 两 个 概念 ， 就 能 更 容易 地 理解 这 两 种 类 型 之 间 的 关系 。 

代码 清单 5-52 展示 了 使 用 user 类 型 的 指针 接收 者 声明 名 为 notify 的 方法 。 这 个 方法 只 
是 显示 一 行 友好 的 信息 ， 表 示 将 邮件 发 给 了 特定 的 用 户 以 及 邮件 地 址 。 





代码 清单 5-52 listing50.go: 第 15 行 到 第 21 行 
15 // notify 实现 了 一 个 可 以 通过 user 类 型 值 的 指针 





























16 // 调用 的 方法 


17 func (u *user) notify() { 





18 fmt.Printf("Sending user email to %s<%s>\n", 
19 u.name, 

20 u.email) 

21 } 


现在 ， 让 我 们 来 看 一 下 main 函数 ， 如 代码 清单 5-53 所 示 。 





代码 清单 5-53 listing50.go: 第 30 行 到 第 45 行 























30 func main() { 

3 // 创建 一 个 admin 用 户 

这 友 ad := admint 

33 user: usert{ 

34 name: "john smith", 
35 email: "john@yahoo.com", 
36 }, 

37 level: "super", 

38 } 

39 

40 // 我 们 可 以 直接 访问 内 部 类 型 的 方法 
41 ad.user.notify() 

42 

43 // 内 部 类 型 的 方法 也 被 提升 到 外 部 类 型 
44 adq.notify() 

45 } 


代码 清单 5-53 中 的 main 函数 展示 了 舱 入 类 型 背后 的 机 制 。 在 第 32 行 , 创建 了 一 个 adamin 
类 型 的 值 。 内 部 类 型 的 初始 化 是 用 结构 字面 量 完成 的 。 通 过 内 部 类 型 的 名 字 可 以 访问 内 部 类 型 ， 
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如 代码 清单 5-54 所 示 。 对 外 部 类 型 来 说 ， 内 部 类 型 总 是 存在 的 。 这 就 意味 着 ,虽然 没有 指定 内 
部 类 型 对 应 的 字段 名 ， 还 是 可 以 使 用 内 部 类 型 的 类 型 名 ， 来 访问 到 内 部 类 型 的 值 。 


代码 清单 5-54 listing50.go: 第 40 行 到 第 41 行 
40 // 我 们 可 以 直接 访问 内 部 类 型 的 方法 


























41 ad.user.notify() 

在 代码 清单 5-54 中 第 41 行 , 可 以 看 到 对 notify 方法 的 调用 。 这 个 调用 是 通过 直接 访问 内 
部 类 型 user 来 完成 的 。 这 展示 了 内 部 类 型 是 如 何 存在 于 外 部 类 型 内 , 并 且 总 是 可 访问 的 。 不 过 ， 
营 助 内 部 类 型 提升 ，notify 方法 也 可 以 直接 通过 ad 变量 来 访问 ， 如 代码 清单 5-55 所 示 。 





代码 清单 5-55 listing50.go: 第 43 行 到 第 45 行 


43 // 内 部 类 型 的 方法 也 被 提升 到 外 部 类 型 
44 adq.notify() 
45 } 


代码 清单 5-55 的 第 44 行 中 展示 了 直接 通过 外 部 类 型 的 变量 来 调用 notify 方法 。 由 于 内 部 
类 型 的 标识 符 提升 到 了 外 部 类 型 , 我 们 可 以 直接 通过 外 部 类 型 的 值 来 访问 内 部 类 型 的 标识 符 。 让 
我 们 修改 一 下 这 个 例子 ， 加 入 一 个 接口 ， 如 代码 清单 5-56 所 示 。 


代码 清单 5-56 listing56.go 


01 // 这 个 示例 程序 展示 如 何 将 嵌入 类 型 应 用 于 接口 


02 Package main 























03 

04 import ( 
05 rn 
06 ) 

07 


08 // notifier 是 一 个 定义 了 

09 // 通知 类 行为 的 接口 

type notifier interface { 
notify() 

















} 














1 

2 

3 

4 // user 在 程序 里 定义 一 个 用 户 类 型 
5 type user struct { 
6 
7 
8 














name string 
email string 





} 





Oo 











20 // 通过 user 类 型 值 的 指针 
21 // 调用 的 方法 


22 func (u *user) notify() { 

















和 2 fmt.Printf("Sending user email to %s<%s>\n", 
24 u.name, 
25 u.email) 





28 // aqmin 代表 一 个 拥有 权限 的 管理 员 用 户 
29 type aqmin struct { 


30 user 
31 level 
32 } 

33 


34 // main 是 
35 func main 








string 








应 用 程序 的 入 
() { 









































36 // 创建 一 个 admin 用 户 

3:7 ad := admint{ 

38 user: usert{ 

39 name: "john smith", 

40 email: "john@yahoo.com", 
41 a 

42 level: "super", 

43 } 

44 

45 // 给 admin 用 户 发 送 一 个 通知 





























46 // 用 于 实现 接口 的 内 部 类 型 的 方法 ， 被 提升 到 
47 // 外 部 类 型 


48 sendNotification(&ad) 





49 } 


51 // sendNo 


tification 接受 一 个 实现 了 notifier 接口 的 值 








52 // 并 发 送 通知 








53 func senqNotification(n notifier) { 
54 n.notify() 


55 省 





代码 清单 5-56 所 示 的 示例 程序 的 大 部 分 和 之 前 的 程序 相同 ， 只 有 一 些小 变化 ,如 代码 清 


单 5-57 所 示 。 





代码 清单 5-57 第 08 行 到 第 12 行 ， 第 51 行 到 第 55 行 


08 // notifier 是 一 个 定义 了 














09 // 通知 类 行为 的 接口 


10 七 YPe noti 


fier interface { 


11 notify() 


12 } 


51 // sendNo 


tification 接受 一 个 实现 了 notifier 接口 的 值 











52 // 并 发 送 通知 
53 func senqNotification(n notifier) { 
54 n.notify() 





D5- 


在 代码 清单 5-57 的 第 08 行 ， 声明 了 一 个 notifier 接口 。 之 后 在 第 53 行 ， 有 一 个 


sendNotificat 


ion 国 数 ， 接 受 notifier 类 型 的 接口 的 值 。 从 代码 可 以 知道 ，user 类 型 之 


前 声明 了 名 为 notify 的 方法 ,该 方法 使 用 指针 接收 者 实现 了 了 notifier 接口 。 之 后 ， 让 我 们 
看 一 下 main 函数 的 改动 ， 如 代码 清单 5-58 所 示 。 
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代码 清单 5-58 listing56.go: 第 35 行 到 第 49 行 


35 func main() { 


















































36 // 创建 一 个 admin 用 户 

3.7 ad := aqmini{ 

38 user: usert{ 

39 name: "john smith", 

40 email: "john@yahoo.com", 
41 }, 

42 level: "super"™, 

43 } 

44 

45 // 给 admin 用 户 发 送 一 个 通知 

46 // 用 于 实现 接口 的 内 部 类 型 的 方法 ， 被 提升 到 
47 // 外 部 类 型 

48 sendNotification(&ad) 

49 } 


这 里 才 是 事情 变 得 有 趣 的 地 方 。 在 代码 清单 5-58 的 第 37 行 ， 我们 创建 了 一 个 名 为 ad 的 变 
量 ， 其 类 型 是 外 部 类 型 aqmin。 这 个 类 型 内 部 脱 和 人 了 user 类 型 。 之 后 第 48 行 ， 我 们 将 这 个 外 
部 类 型 变量 的 地 址 传 给 senqNotification 函数 。 编 译 器 认为 这 个 指针 实现 了 notifier 接 
口 ， 并 接受 了 这 个 值 的 传递 。 不 过 如 果 看 一 下 整个 示例 程序 ， 就 会 发 现 admin 类 型 并 没有 实现 
这 个 接口 。 

由 于 内 部 类 型 的 提升 , 内 部 类 型 实现 的 接口 会 自动 提升 到 外 部 类 型 。 这 意味 着 由 于 内 部 类 型 的 
实现 ， 外 部 类 型 也 同样 实现 了 这 个 接口 。 运 行 这 个 示例 程序 ， 会 得 到 代码 清单 5-59 所 示 的 输出 。 


代码 清单 5-59 listing56.go 的 输出 
20 // 通过 user 类 型 值 的 指针 
21 // 调用 的 方法 


22 func (u *user) notify() { 
































23 fmt.Printf ("Sending user email to %s<%s>\n", 
24 u.name, 

25 u.email) 

26 } 

Qutputs 


Sending user email to john smith<john@yahoo.com> 

可 以 在 代码 清单 5-59 中 看 到 内 部 类 型 的 实现 被 调用 。 

如 果 外 部 类 型 并 不 需要 使 用 内 部 类 型 的 实现 , 而 想 使 用 自己 的 一 套 实现 , 该 怎么 办 ?让 我 们 
看 另 一 个 示例 程序 是 如 何 解决 这 个 问题 的 ， 如 代码 清单 5-60 所 示 。 


代码 清单 5-60 listing60.go 
01 // 这 个 示例 程序 展示 当 内 部 类 型 和 外 部 类 型 要 
02 // 实现 同一 个 接口 时 的 做 法 


03 Package main 
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import ( 
mfmtn 
) 


5.5 ”和 能 入 类 型 


// notifier 是 一 个 定义 了 
// 通知 类 行为 的 接口 














type notifier interface { 
notify() 


} 











// user 在 程序 里 定义 一 个 用 户 类 型 

















type user 
name 
email 











// 通过 use 




















// 调用 的 方法 





struct { 
string 
string 


r 类 型 值 的 指针 





func (u *user) notify() { 


fmt.Printf ("Sending user email to %s<%s>\n", 


LU。 
LU。 


} 


// agmin 代表 一 个 拥有 权限 的 管理 


name, 
email) 














学 
I 














type admin struct { 


user 
level 








// 通过 adm 























// 调用 的 方法 





string 


in 类 型 值 的 指针 





func (a *admin) notify() { 


fmt.Printf ("Sending admin email to %s<%s>\n", 


a. 
a. 


} 


name, 
email) 











// main 是 应 用 程序 的 入 

















func main() { 


// 创建 一 个 admin 用 户 





ad := 


user: usert{ 


有 

















admint{ 





name: "john smith", 
email: "john@yahoo.com", 


level: "super", 


} 























// 给 aqmin 用 户 发 送 一 个 通知 























// 接 





的 嵌入 的 内 部 类 型 实现 并 没有 提升 到 





// 外 部 类 型 
sendNotification(&ad) 
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58 

59 // 我 们 可 以 直接 访问 内 部 类 型 的 方法 
60 adq.user.notify() 

61 

62 // 内 部 类 型 的 方法 没有 被 提升 

63 adq.notify() 

64 } 

65 











66 // sendNotification 接受 一 个 实现 了 notifier 接口 的 值 
67 // 并 发 送 通知 

68 func sendNotification(n notifier) { 

69 n.notify() 

405 


代码 清单 5-60 所 示 的 示例 程序 的 大 部 分 和 之 前 的 程序 相同 ， 只 有 一 些小 变化 , 如 代码 清 
单 5-61 所 示 。 














代码 清单 5-61 listing60.go: 第 35 行 到 第 41 行 
35 // 通过 aqmin 类 型 值 的 指针 

















36 // 调用 的 方法 
37 func (a *admin) notify() { 





38 fmt.Printf("Sending admin email to %s<%s>\n", 
39 a.name, 

40 a.email) 

下 


这 个 示例 程序 为 admin 类 型 增加 了 notifier 接口 的 实现 。 当 agmin 类 型 的 实现 被 调用 
时 , 会 显示 "Sending admin email"。 作 为 对 比 ，user 类 型 的 实现 被 调用 时 ,会 显示 "Sending 
user email", 


main 函数 里 也 有 一 些 变 化 ， 如 代码 清单 5-62 所 示 。 





代码 清单 5-62 listing60.go: 第 43 行 到 第 64 行 



























































43 // main 是 应 用 程序 的 入 

44 func main() { 

45 // 创建 一 个 admin 用 户 

46 ad := admint{ 

47 user: usert{ 

48 name: "john smith", 
49 email: "john@yahoo.com", 
50 }, 

S51 level: "super", 

52 } 

53 

54 // 给 aqmin 用 户 发 送 一 个 通知 














55 /7/ 接口 的 嵌入 的 内 部 类 型 实现 并 没有 提升 到 
56 // 外 部 类 型 

57 sendNotification (&ad) 

58 

59 // 我 们 可 以 直接 访问 内 部 类 型 的 方法 





























60 adq.uUuser.notify() 


61 

62 // 内 部 类 型 的 方法 没有 被 提升 
63 adq.notify() 

64 } 


代码 清单 5-62 的 第 46 行 ， 我 们 再 次 创建 了 外 部 类 型 的 变量 ad。 在 第 57 行 ,将 ad 变量 的 
地 址 传 给 sengdNotification 也 数 ， 这 个 指针 实现 了 接口 所 需要 的 方法 集 。 在 第 60 行 ， 代码 
直接 访问 user 内 部 类 型 ， 并 调用 notify 方法 。 最 后 ， 在 第 63 行 ， 使 用 外 部 类 型 变量 ad 来 
调用 notify 方法 。 当 查看 这 个 示例 程序 的 输出 ( 如 代码 清单 5-63 所 示 ) 时 ， 就 会 看 到 区 别 。 











代码 清单 5-63 ”listing60.go 的 输出 


Sending admin email to john smith<john@yahoo.com> 
Sending user email to john smithn<john@yahoo.com> 
Sending admin email to john smith<john@yahoo.com> 


这 次 我 们 看 到 了 admin 类 型 是 如 何 实现 notifier 接口 的 ， 以 及 如 何 由 sendNotification 
函数 以 及 直接 使 用 外 部 类 型 的 变量 ad 来 执行 admin 类 型 实现 的 方法 。 这 表明 ， 如 果 外 部 类 型 
实现 了 notify 方 法 , 内 部 类 型 的 实现 就 不 会 被 提升 。 不 过 内 部 类 型 的 值 一 直 存在 , 因此 还 可 以 
通过 直接 访问 内 部 类 型 的 值 ， 来 调用 没有 被 提升 的 内 部 类 型 实现 的 方法 。 


xX% ”公开 或 未 公开 的 标识 符 


要 想 设计 出 好 的 API， 需 要 使 用 某 种 规则 来 控制 声明 后 的 标识 符 的 可 见 性 。Go 语言 支持 从 
包 里 公开 或 者 隐藏 标识 符 。 通 过 这 个 功能 ， 让 用 户 能 按照 自己 的 规则 控制 标识 符 的 可 见 性 。 在 第 
3 章 讨 论 包 的 时 候 ， 谈 到 了 如 何 从 一 个 包 引 入 标识 符 到 另 一 个 包 。 有 时 候 ， 你 可 能 不 希望 公开 包 
里 的 某 个 类 型 、 函 数 或 者 方法 这 样 的 标识 符 。 在 这 种 情况 ， 需 要 一 种 方法 ,将 这 些 标识 符 声明 为 
包 外 不 可 见 ， 这 时 需要 将 这 些 标识 符 声 明 为 未 公开 的 。 

让 我 们 用 一 个 示例 程序 来 演示 如 何 隐藏 包 里 未 公开 的 标识 符 ， 如 代码 清单 5-64 所 示 。 


代码 清单 5-64 listing64/ 


counters/counters .go 











01 // counters 包 提 供 告警 计数 器 的 功能 
02 Package counters 
































04 // alertCounter 是 一 个 未 公开 的 类 型 
05 // 这 个 类 型 用 于 保存 告警 计数 
06 type alertCounter int 








listing64.g0o 





01 // 这 个 示例 程序 展示 无 法 从 另 一 个 包 里 
02 // 访问 未 公开 的 标识 符 

















03 Package main 



























































04 

05 import ( 

06 fmt 

07 

08 "github.com/goinaction/code/chapter5/listing64/counters" 
09 ) 

10 

11 // main 是 应 用 程序 的 入 

12 func main() { 

3 // 创建 一 个 未 公开 的 类 型 的 变量 

4 // 并 将 其 初始 化 为 10 

15 counter := counters.alertCounter (10) 

6 

7 // ./listing64.go:15: 不 能 引用 未 公开 的 名 字 

18 // counters.alertCounter 

19 // ./listing64.go:15: 未 定义 : counters.alertCounter 
20 
2 fmt.Printf("Counter: Sd\n", counter) 
22 二 


这 个 示例 程序 有 两 个 代码 文件 。 一 个 代码 文件 名 字 为 counters.go， 保 存在 counters 包 里 ; 
另 一 个 代码 文件 名 字 为 listing64.go， 导 入 了 counters 包 。 让 我 们 先 从 counters 包 里 的 代码 
开始 ， 如 代码 清单 5-65 所 示 。 


代码 清单 5-65 counters/counters.go 


01 // counters 包 提 供 告警 计数 器 的 功能 
02 package counters 
































04 // alertCounter 是 一 个 未 公开 的 类 型 
05 // 这 个 类 型 用 于 保存 告警 计数 
06 type alertCounter int 


代码 清单 5-65 展示 了 只 属于 counters 包 的 代码 。 你 可 能 会 首先 注意 到 第 02 行 。 直 到 现在 ， 
之 前 所 有 的 示例 程序 都 使 用 了 package main， 而 这 里 用 到 的 是 package counters。 当 要 
写 的 代码 属于 某 个 包 时 ,好 的 实践 是 使 用 与 代码 所 在 文件 夹 一 样 的 名 字 作 为 包 名 。 所 有 的 Go 工 
具 都 会 利用 这 个 习惯 ， 所 以 最 好 遵守 这 个 好 的 实践 。 

在 counters 包 里 ,我 们 在 第 06 行 声 明了 唯一 一 个 名 为 alertcounter 的 标识 符 。 这 个 
标识 符 是 一 个 使 用 int 作为 基础 类 型 的 类 型 。 需 要 注意 的 是 ， 这 是 一 个 未 公开 的 标识 符 。 

当 一 个 标识 符 的 名 字 以 小 写字 母 开 头 时 ， 这 个 标识 符 就 是 未 公开 的 ， 即 包 外 的 代码 不 可 见 。 
如 果 一 个 标识 符 以 大 写字 母 开 头 ， 这 个 标识 符 就 是 公开 的 , 即 被 包 外 的 代码 可 见 。 让 我 们 看 一 下 
导入 这 个 包 的 代码 ， 如 代码 清单 5-66 所 示 。 


代码 清单 5-66 listing64.go 


01 // 这 个 示例 程序 展示 无 法 从 另 一 个 包 里 
02 // 访问 未 公开 的 标识 符 






































03 Package main 





















































04 

05 import ( 

06 fmt 

07 

08 "github.com/goinaction/code/chapter5/listing64/counters" 
09 ) 

10 

11 // main 是 应 用 程序 的 入 

12 func main() { 

13 // 创建 一 个 未 公开 的 类 型 的 变量 

14 // 并 将 其 初始 化 为 10 

15 counter := counters.alertCounter (10) 

16 

了 // ./listing64.go:15: 不 能 引用 未 公开 的 名 字 

18 Ah counters.alertCounter 
19 // ./listing64.go:15: 未 定义 : counters.alertCounter 

20 

之 二 fmt.Printf("Counter: Sd\n", counter) 

2 这 2 让 


代码 清单 5-66 中 的 listing64.go 的 代码 在 第 03 行 声明 了 main 包 ， 之 后 在 第 08 行 导 入 了 
counters 包 。 在 这 之 后 ,我 们 跳 到 main 函数 里 的 第 15 行 ， 如 代码 清单 5-67 所 示 。 





代码 清单 5-67 listing64.go: 第 13 到 19 行 
// 创建 一 个 未 公开 的 类 型 的 变量 


13 
14 
i5 
16 
17 
18 
19 

















// 并 将 其 初始 化 为 10 


counter := counters.alertCounter (10) 














// ./listing64.go:15: 不 能 引用 未 公开 的 名 字 
// counters.alertCounter 
// ./listing64.go:15: 未 定义 : counters.alertCounter 


在 代码 清单 5-67 的 第 15 行 , 代码 试图 创建 未 公开 的 alertcounter 类 型 的 值 。 不 过 这 段 代码 会 
造成 第 15 行 展 示 的 编译 错误 , 这 个 编译 错误 表明 第 15 行 的 代码 无 法 引用 counters.alertCounter 
这 个 未 公开 的 标识 符 。 这 个 标识 符 是 未 定义 的 。 

由 于 counters 包 里 的 alertCounter 类 型 是 使 用 小 写字 母 声 明 的 ， 所 以 这 个 标识 符 是 未 
公开 的 ， 无 法 被 listing64.go 的 代码 访问 。 如 果 我 们 把 这 个 类 型 改 为 用 大 写字 母 开 头 ， 那 么 就 不 
会 产生 编译 需 错 误 。 让 我 们 看 一 下 新 的 示例 程序 , 如 代码 清单 5-68 所 示 , 这 个 程序 在 counters 





包 里 实现 了 工厂 函数 。 


代码 清单 5-68 listing68/ 


counters/counters .go 




















01 // counters 包 提 供 告警 计数 器 的 功能 


02 package counters 


03 














04 // alertCounter 是 一 个 未 公开 的 类 型 


05 
06 
07 
08 
09 
10 
11 
12 


上 





// 这 个 类 型 用 于 保存 告警 计数 


type alertCounter int 




















// New 创建 并 返回 一 个 未 公开 的 

// alertCounter 类 型 的 值 

func New(value int) alertCounter { 
return alertCounter (value) 





} 


listing68.g0o 





oo ~ 局 世上 ON 请 


这 


// 这 个 示例 程序 展示 如 何 访问 另 一 个 包 的 未 公开 的 
// 标识 符 的 值 


Package main 

















import ( 
TY fmt TY 


"github.com/goinaction/code/chapter5/1listing68/counters" 
) 











// main 是 应 用 程序 的 入 
func main() { 
// 使 用 counters 包公 开 的 New 函数 来 创建 
// 一 个 未 公开 的 类 型 的 变量 


counter := counters.New(10) 









































fmt.Printf("Counter: Sd\n", counter) 


} 


个 例子 已 经 修改 为 使 用 工厂 函数 来 创建 一 个 未 公开 的 alertcounter 类 型 的 值 。 让 我 们 





先 看 一 下 counters 包 的 代码 ， 如 代码 清单 5-69 所 示 。 


代码 清单 5-69 counters/counters.go 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 














// counters 包 提供 告警 计数 器 的 功能 
package counters 




















// alertCounter 是 一 个 未 公开 的 类 型 
// 这 个 类 型 用 于 保存 告警 计数 


type alertCounter int 




















// New 创建 并 返回 一 个 未 公开 的 

// alertCounter 类 型 的 值 

func New(value int) alertCounter { 
return alertCounter (value) 





} 


代码 清单 5-69 展示 了 我 们 对 counters 包 的 改动 。alertcounter 类 型 依旧 是 未 公开 的 ， 
不 过 现在 在 第 10 行 增加 了 一 个 名 为 New 的 新 函数 。 将 工厂 函数 命名 为 New 是 Go 语言 的 一 个 习 
惯 。 这 个 New 函数 做 了 些 有 意思 的 事情 : 它 创 建 了 一 个 未 公开 的 类 型 的 值 ， 并 将 这 个 值 返回 给 








调用 者 。 让 我 们 看 一 下 listing68.go 的 main 函数， 如 代码 清单 5-70 所 示 。 


代码 清单 5-70 listing68.go 
11 // main 是 应 用 程序 的 入 


12 func main() { 
13 // 使 用 counters 包公 开 的 New 函数 来 创建 
// 一 个 未 公开 的 类 型 的 变量 


counter := counters.New(10) 












































fmt.Printf("Counter: Sd\n", counter) 





a 
oo ~QOOU 心 


} 

在 代码 清单 5-70 的 第 15 行 ， 可 以 看 到 对 counters 包 里 New 函数 的 调用 。 这 个 New 函数 
返回 的 值 被 赋 给 一 个 名 为 counter 的 变量 。 这 个 程序 可 以 编译 并 且 运 行 , 但 为 什么 呢 ?New 瑞 
数 返回 的 是 一 个 未 公开 的 alertcounter 类 型 的 值 ， 而 main 函数 能 够 接受 这 个 值 并 创建 一 个 
未 公开 的 类 型 的 变量 。 

要 让 这 个 行为 可 行 ， 需 要 两 个 理由 。 第 一 ， 公 开 或 者 未 公开 的 标识 符 ， 不 是 一 个 值 。 第 二 ， 
短 变量 声明 操作 符 ， 有 能 力 捕获 引用 的 类 型 ， 并 创建 一 个 未 公开 的 类 型 的 变量 。 永 远 不 能 显 式 创 
建 一 个 未 公开 的 类 型 的 变量 ， 不 过 短 变量 声明 操作 符 可 以 这 么 做 。 

让 我 们 看 一 个 新 例子 , 这 个 例子 展示 了 这 些 可 见 的 规则 是 如 何 影响 到 结构 里 的 字段 , 如 代码 
清单 5-71 所 示 。 


代码 清单 5-71 listing71/ 


entities/entities.go 


01 // entities 包 包 含 系统 中 

02 // 与 人 有 关 的 类 型 

03 Package entities 

04 

05 // User 在 程序 里 定义 一 个 用 户 类 型 
06 type User struct { 














07 Name string 
08 email string 
09 } 


listing71.go 


01 // 这 个 示例 程序 展示 公开 的 结构 类 型 中 未 公开 的 字段 
02 // 无 法 直接 访问 


03 Package main 








04 

05 import ( 

06 Vm 

07 

08 "github.com/goinaction/code/chapter5/listing71l/entities" 
09 ) 














11 // main 是 应 用 程序 的 入 








12 func main() { 

13 // 创建 entities 包 中 的 User 类 型 的 值 
14 u := entities.Usert{ 

15 Name: "Bill", 

16 email: "pbill@email.com", 

17 } 

18 

19 // ./example69.go:16: 结构 字面 量 中 结构 entities.User 
20 // 的 字段 ' emai1l’ 未 知 
生 

22 fmt.Printf("User: Sv\n", u) 

237 中 


代码 清单 5-71 中 的 代码 有 一 些微 妙 的 变化 。 现 在 我 们 有 一 个 名 为 entities 的 包 ， 声 明了 
名 为 User 的 结构 类 型 ， 如 代码 清单 5-72 所 示 。 


代码 清单 5-72 entities/entities.go 


01 // entities 包 包 含 系统 中 

02 // 与 人 有 关 的 类 型 

03 package entities 

04 

05 // User 在 程序 里 定义 一 个 用 户 类 型 
06 type User struct { 














07 Name string 
08 email string 
09 } 


代码 清单 5-72 的 第 06 行 中 的 User 类 型 被 声明 为 公开 的 类 型 。User 类 型 里 声明 了 两 个 字段 ， 
一 个 名 为 Name 的 公开 的 字段 ， 一 个 名 为 email 的 未 公开 的 字段 。 让 我 们 看 一 下 listing71.go 的 
代码 ， 如 代码 清单 5-73 所 示 。 


代码 清单 5-73 listing71.go 
01 // 这 个 示例 程序 展示 公开 的 结构 类 型 中 未 公开 的 字段 
02 // 无 法 直接 访问 


03 Package main 











04 

05 import ( 

06 Wm" 

07 

08 "github.com/goinaction/code/chapter5/listing71l/entities" 
09 ) 

10 

11 // main 是 程序 的 入 口 

12 func main() { 

13 // 创建 entities 包 中 的 User 类 型 的 值 
14 u := entities.Usert{ 

15 Name: "Bill", 

16 email: "pbill@email.com", 


17 } 


19 // ./example69.go:16: 结构 字面 量 中 结构 entities.User 
20 // 的 字段 'email' 未 知 

21 

人 22 fmt.Printf("User: Sv\n", u) 

23 } 





代码 清单 5-73 的 第 08 行 导入 了 entities 包 。 在 第 14 行 声明 了 entities 包 中 的 公开 的 
类 型 User 的 名 为 u 的 变量 ， 并 对 该 字段 做 了 初始 化 。 不 过 这 里 有 一 个 问题 。 第 16 行 的 代码 试 
图 初始 化 未 公开 的 字段 email， 所 以 编译 器 抱怨 这 是 个 未 知 的 字段 。 因 为 email 这 个 标识 符 未 
公开 ， 所 以 它 不 能 在 entities 包 外 被 访问 。 

让 我 们 看 最 后 一 个 例子 , 这 个 例子 展示 了 公开 和 未 公开 的 内 艇 类 型 是 如 何 工 作 的 ,如 代码 清 
单 5-74 所 示 。 


代码 清单 5-74 listing74/ 


entities/entities.go 


01 // entities 包 包 含 系统 中 
02 // 与 人 有 关 的 类 型 


03 package entities 











05 // user 在 程序 里 定义 一 个 用 户 类 型 
06 type user struct { 














07 Name string 
08 Email string 
09 } 

10 


11 // admin 在 程序 里 定义 了 管理 员 

12 type Adqmin struct { 

13 user // 嵌入 的 类 型 是 未 公开 的 
14 Rights int 








listing74.g0o 
01 // 这 个 示例 程序 展示 公开 的 结构 类 型 中 如 何 访 问 
02 // 未 公开 的 内 嵌 类 型 的 例子 


03 Package main 






































04 

05 import ( 

06 mf 

07 

08 "github.com/goinaction/code/chapter5/listing74/entities" 
09 ) 

10 

11 // main 是 应 用 程序 的 入 

12 func main() { 

13 // 创建 entities 包 中 的 Aqmin 类 型 的 值 


14 a := entities.Admint{ 


24 


Rights: 10, 
} 











// 设置 未 公开 的 内 部 类 型 的 





// 公开 字段 的 值 
a.Name = "Bill" 
a.Email = "bill@email.com" 


fmt .Printf ("User: 
} 


Sv\n", a) 


现在 ， 在 代码 清单 5-74 里 ，entities 包 包 含 两 个 结构 类 型 ， 如 代码 清单 5-75 所 示 。 


代码 清单 5-75 ”entities/entities.go0 


// entities 包 包含 系统 中 
// 与 人 有 关 的 类 型 


Package entities 


// user 在 程序 里 定义 一 个 月 
type user struct { 
Name string 
Email string 








} 


上 





户 类 型 


// Rdmin 在 程序 里 定义 了 管理 员 








type Admin struct { 


user // 嵌入 的 类 型 未 公 


Rights int 
} 














在 代码 清单 5-75 的 第 06 行 ， 声明 了 一 个 未 公开 的 结构 类 型 user。 这 个 类 型 包括 两 个 公开 
的 字段 Name 和 Email。 在 第 12 行 ， 声明 了 一 个 公开 的 结构 类 型 Admin。Rdmin 有 一 个 名 为 
Rights 的 公开 的 字段 ， 而 且 般 入 一 个 未 公开 的 user 类 型 。 让 我 们 看 一 下 listing74.go 的 main 
函数 ， 如 代码 清单 5-76 所 示 。 


代码 清单 5-76 





listing74.go: 第 11 到 24 行 





14 入 
12 
13 
14 
15 
16 
































// main 是 应 用 程序 的 入 
func main() { 
// 创建 entities 包 中 的 Aqmin 类 型 的 值 
a := entities.Admint{ 
Rights: 10, 
} 
// 设置 未 公开 的 内 部 类 型 的 
// 公开 字段 的 值 
a.Name = "Bill" 
a.Email = "bill@email.com" 
fmt.Printf("User: Sv\n", a) 


让 我 们 从 代码 清单 5-76 的 第 14 行 的 main 函数 开始 。 这 个 函数 创建 了 entities 包 中 的 
Aqmin 类 型 的 值 。 由 于 内 部 类 型 user 是 未 公开 的 ， 这 段 代码 无 法 直接 通过 结构 字面 量 的 方式 初 


始 化 该 内 部 类 型 。 不过， 即便 内 部 类 型 是 未 公开 的 ， 内 部 类 型 里 声明 的 字段 依旧 是 公 



































开 的 。 既 然 


内 部 类 型 的 标识 符 提 升 到 了 外 部 类 型 这些 公开 的 字段 也 可 以 通过 外 部 类 型 的 字段 的 值 来 访问 。 


因此 ， 在 第 20 行 和 第 21 行 ,来 自 未 公开 的 内 部 类 型 的 字段 Name 和 : 





























Email 可 以 通过 外 部 


类 型 的 变量 a 被 访问 并 被 初始 化 。 因 为 uset 类 型 是 未 公开 的 ， 所 以 这 里 没有 直接 访问 内 部 类 型 。 


x% 小 结 











使 用 关键 字 struct 或 者 通过 指定 已 经 存在 的 类 型 ， 可 以 声明 用 户 定义 的 
方法 提供 了 一 种 给 用 户 定 义 的 类 型 增加 行为 的 方式 。 

设计 类 型 时 需要 确认 类 型 的 本 质 是 原始 的 ， 还 是 非 原 始 的 。 

接口 是 声明 了 一 组 行为 并 支持 多 态 的 类 型 。 

和 能 和 类 型 提供 了 扩展 类 型 的 能 力 ， 而 无 需 使 用 继承 。 














标识 符 要 么 是 从 包 旦 

















有 公开 的 ， 要 么 是 在 包 里 未 公开 的 。 


类 型 。 





本 章 主要 内 容 

四 ”使 用 goroutine 运行 程序 
加 ”检测 并 修正 竞争 状态 

加 ”利用 通道 共享 数据 


通常 程序 会 被 编写 为 一 个 顺序 执行 并 完成 一 个 独立 任务 的 代码 。 如 果 没 有 特别 的 需求 , 最 好 
总 是 这 样 写 代码 ， 因 为 这 种 类 型 的 程序 通常 很 容易 写 ,也 很 容易 维护 。 不 过 也 有 一 些 情况 下 ,并 
行 执行 多 个 任务 会 有 更 大 的 好 处 。 一 个 例子 是 ，Web 服务 需要 在 各 自 独 立 的 套 接 字 ( socket ) 上 
同时 接收 多 个 数据 请 求 。 每 个 套 接 字 请 求 都 是 独立 的 ， 可 以 完全 独立 于 其 他 套 接 字 进 行 处 理 。 具 
有 并 行 执行 多 个 请 求 的 能 力 可 以 显著 提高 这 类 系统 的 性 能 。 考 虑 到 这 一 点 ，Go 语言 的 语法 和 运 
行 时 直接 内 置 了 对 并 发 的 支持 。 

Go 语言 里 的 并 发 指 的 是 能 让 某 个 函数 独立 于 其 他 函数 运行 的 能 力 。 当 一 个 函数 创建 为 goroutine 
时 ，Go 会 将 其 视 为 一 个 独立 的 工作 单元 。 这 个 单元 会 被 调度 到 可 用 的 逻辑 处 理 带 上 执行 。Go 语言 
运行 时 的 调度 器 是 一 个 复杂 的 软件 ， 能 管理 被 创建 的 所 有 goroutine 并 为 其 分 配 执行 时 间 。 这 个 调度 
器 在 操作 系统 之 上 ， 将 操作 系统 的 线程 与 语言 运行 时 的 逻辑 处 理 器 绑 定 ， 并 在 逻辑 处 理 器 上 运行 
goroutine。 调 度 器 在 任何 给 定 的 时 间 ， 都 会 全 面 控制 哪个 goroutine 要 在 哪个 逻辑 处 理 器 上 运行 。 

Go 语言 的 并 发 同步 模型 来 自 一 个 叫 作 通 信 顺 序 进程 (Communicating Sequential Processes，CSP ) 
的 范 型 (paradigm )。CSP 是 一 种 消息 传递 模型 ， 通 过 在 goroutine 之 间 传 递 数 据 来 传递 消息 ， 而 不 是 
对 数据 进行 加 锁 来 实现 同步 访问 。 用 于 在 goroutine 之 间 同 步 和 传递 数据 的 关键 数据 类 型 叫 作 通道 
( channel )。 对 于 没有 使 用 过 通道 写 并 发 程序 的 程序 员 来 说 ， 通 道 会 让 他 们 感觉 神奇 而 兴奋 。 和 希望 读 
者 使 用 后 也 能 有 这 种 感觉 。 使 用 通道 可 以 使 编写 并 发 程序 更 容易 ， 也 能 够 让 并 发 程序 出 错 更 少 。 



























































































































































se 并 发 与 并 行 


让 我 们 先 来 学 习 一 下 抽象 程度 较 高 的 概念 什么 是 操作 系统 的 线程 ( thread ) 和 进程 ( process )。 











这 会 有 助 于 后 面 理解 Go 语言 运行 时 调度 器 如 何 利用 操作 系统 来 并 发 运行 goroutine。 当 运行 一 个 
应 用 程序 ( 如 一 个 IDE 或 者 编辑 恬 ) 的 时 候 , 操作 系统 会 为 这 个 应 用 程序 启动 一 个 进程 。 可 以 将 
这 个 进程 看 作 一 个 包含 了 应 用 程序 在 运行 中 需要 用 到 和 维护 的 各 种 资源 的 容器 。 

图 6-1 展示 了 一 个 包含 所 有 可 能 分 配 的 常用 资源 的 进程 。 这 些 资源 包括 但 不 限于 内 存 地 址 空 
间 、 文 件 和 设备 的 句柄 以 及 线程 。 一 个 线程 是 一 个 执行 空间 ,这 个 空间 会 被 操作 系统 调度 来 运行 
函数 中 所 写 的 代码 。 每 个 进程 至 少 包含 一 个 线程 ,每 个 进程 的 初始 线程 被 称 作 主 线程 。 因 为 执行 
这 个 线程 的 空间 是 应 用 程序 的 本 身 的 空间 ,所 以 当主 线程 终止 时 , 应 用 程序 也 会 终止 。 操 作 系统 
将 线程 调度 到 某 个 处 理 器 上 运行 , 这 个 处 理 器 并 不 一 定 是 进程 所 在 的 处 理 器 。 不 同 操作 系统 使 用 
的 线程 调度 算法 一 般 都 不 一 样 ， 但 是 这 种 不 同 会 被 操作 系统 屏蔽 ， 并 不 会 展示 给 程序 员 。 



























































进程 维护 了 应 用 程序 运行 时 的 内 存 地 址 空间 、 文 件 和 设备 的 句柄 以 及 线程 。 
操作 系统 的 调度 器 决定 哪个 线程 会 获得 给 定 的 CPU 的 运行 时 间 。 


\ 











内 存 句柄 线程 
主线 程 
代码 | | 代码 | | 代码 | | 代码 | | 代码 











| 操作 系统 调度 器 | 系统 调度 器 


图 6-1 一 个 运行 的 应 用 程序 的 进程 和 线程 的 简要 描绘 

















操作 系统 会 在 物理 处 理 器 上 调度 线程 来 运行 ， 而 Go 语言 的 运行 时 会 在 逻辑 处 理 器 上 调度 
goroutine 来 运行 。 每 个 逻辑 处 理 器 都 分 别 绑 定 到 单个 操作 系统 线程 。 在 1.5 版 本 "上 ，Go 语 言 的 
运行 时 默认 会 为 每 个 可 用 的 物理 处 理 器 分 配 一 个 逻辑 处 理 器 。 在 1.5 版 本 之 前 的 版 本 中 ， 默 认 给 
整个 应 用 程序 只 分 配 一 个 逻辑 处 理 锅 。 这 些 逻 辑 处 理 需 会 用 于 执行 所 有 被 创建 的 goroutine。 即 便 
只 有 一 个 逻辑 处 理 器 ，Go 也 可 以 以 神奇 的 效率 和 性 能 ， 并 发 调度 无 数 个 goroutine。 

在 图 6-2 中 ,可 以 看 到 操作 系统 线程 、 逻 辑 处 理 器 和 本 地 运行 队列 之 间 的 关系 。 如 果 创 建 一 
个 goroutine 并 准备 运行 ， 这 个 goroutine 就 会 被 放 到 调度 器 的 全 局 运行 队列 中 。 之 后 ， 调 度 器 就 
将 这 些 队列 中 的 goroutine 分 配给 一 个 逻辑 处 理 句 ， 并 放 到 这 个 逻辑 处 理 器 对 应 的 本 地 运行 队列 

















Q@ 直到 目前 最 新 的 1.8 版 本 都 是 同一 逻辑 。 可 预见 的 未 来 版 本 也 会 保持 这 个 逻辑 。 一 一 译 者 注 
































中 。 本 地 运行 队列 中 的 goroutine 会 一 直 等 待 直 到 自己 被 分 配 的 逻辑 处 理 器 执行 。 





Go 语言 运行 时 会 把 goroutine 调 度 到 逻辑 处 理 器 当 goroutine 执 行 了 一 个 阻塞 的 系统 调用 时 ， 


上 运行 。 这 个 远 辑 处 理 器 绑 定 到 唯一 的 操作 系 调度 器 会 将 这 个 线程 与 处 理 器 分 离 ， 并 创 
建 一 个 新 线程 来 运行 这 个 处 理 器 上 提供 的 


统 线程 。 当 goroutine 可 以 运行 的 时 候 ， 会 被 放 
入 逻辑 处 理 器 的 执行 队列 中 。 





图 6-2 ”Go 调度 器 如 何 管理 goroutine 





有 时 ， 正 在 运行 的 goroutine 需要 执行 一 个 阻塞 的 系统 调用 ， 如 打开 一 个 文件 。 当 这 类 调用 
发 生 时 ， 线 程 和 goroutine 会 从 逻辑 处 理 器 上 分 离 ， 该 线程 会 继续 阻塞 ， 等 待 系统 调用 的 返回 。 
与 此 同时 ,这 个 逻辑 处 理 器 就 失去 了 用 来 运行 的 线程 。 所 以 ,调度 器 会 创建 一 个 新 线程 ， 并 将 其 
绑 定 到 该 逻辑 处 理 器 上 。 之 后 ， 调 度 器 会 从 本 地 运行 队列 里 选择 另 一 个 goroutine 来 运行 。 一 旦 
被 阻塞 的 系统 调用 执行 完成 并 返回 ， 对 应 的 goroutine 会 放 回 到 本 地 运行 队列 ， 而 之 前 的 线程 会 
保存 好 ， 以 便 之 后 可 以 继续 使 用 。 

如 果 一 个 goroutine 需要 做 一 个 网 络 IO 调用 ,流程 上 会 有 些 不 一 样 ,在 这 种 情况 下 , goroutine 
会 和 逻辑 处 理 器 分 离 , 并 移 到 集成 了 网 络 轮 询 器 的 运行 时 。 一旦 该 轮 询 器 指示 某 个 网 络 读 或 者 写 
操作 已 经 就 绪 ， 对 应 的 goroutine 就 会 重新 分 配 到 逻辑 处 理 器 上 来 完成 操作 。 调 度 器 对 可 以 创建 
的 逻辑 处 理 器 的 数量 没有 限制 ， 但 语言 运行 时 默认 限制 每 个 程序 最 多 创建 10 000 个 线程 。 这 个 
限制 值 可 以 通过 调用 runtime/debug 包 的 SetMaxThreads 方法 来 更 改 。 如 果 程 序 试 图 使 用 
更 多 的 线程 ， 就 会 月 演 。 

并 发 ( concurrency ) 不 是 并 行人 parallelism )。 并 行 是 让 不 同 的 代码 片段 同时 在 不 同 的 物理 处 
理 器 上 执行 。 并 行 的 关键 是 同时 做 很 多 事情 ， 而 并 发 是 指 同时 管理 很 多 事情 ， 这 些 事情 可 能 只 做 
了 一 半 就 被 暂停 去 做 别 的 事情 了 。 在 很 多 情况 下 ， 并 发 的 效果 比 并 行 好 ， 因 为 操作 系统 和 硬件 的 
总 资源 一 般 很 少 , 但 能 支持 系统 同时 做 很 多 事情 。 这 种 “使 用 较 少 的 资源 做 更 多 的 事情 ”的 哲学 ， 
也 是 指导 Go 语言 设计 的 哲学 。 

如 果 和 希望 计 goroutine 并 行 ， 必 须 使 用 多 于 一 个 逻辑 处 理 器 。 当 有 多 个 逻辑 处 理 器 时 ， 调 度 器 













































































会 将 goroutine 平等 分 配 到 每 个 逻辑 处 理 硕 上。 这 会 让 goroutine 在 不 同 的 线程 上 运行 。 不 过 要 想 真 
的 实现 并 行 的 效果 , 用 户 需 要 让 自己 的 程序 运行 在 有 多 个 物理 处 理 器 的 机 器 上 。 和 否则 ， 哪 怕 Go 语 
言 运行 时 使 用 多 个 线程 ，goroutine 依然 会 在 同一 个 物理 处 理 器 上 并 发 运行 ， 达 不 到 并 行 的 效果 。 
6-3 展示 了 在 一 个 逻辑 处 理 器 上 并 发 运行 goroutine 和 在 两 个 逻辑 处 理 器 上 并 行 运行 两 个 并 
发 的 goroutine 之 间 的 区 别 。 调 度 需 包含 一 些 聪明 的 算法 , 这 些 算法 会 随 着 Go 语言 的 发 布 被 更 新 
和 改进 , 所 以 不 推荐 育 目 修改 语言 运行 时 对 逻辑 处 理 器 的 默认 设置 。 如 果真 的 认为 修改 逻辑 处 理 
器 的 数量 可 以 改进 性 能 , 也 可 以 对 语言 运行 时 的 参数 进行 细微 调整 。 后 面 会 介绍 如 何 做 这 种 修改 。 


并 发 并 行 














图 6-3 并 发 和 并 行 的 区 别 





让 我 们 再 深入 了 人 解 一 下 调度 器 的 行为 ， 以 及 调度 器 是 如 何 创建 goroutine 并 管理 其 寿命 的 。 
我 们 会 先 通过 在 一 个 逻辑 处 理 需 上 运行 的 例子 来 讲解 ， 再 来 讨论 如 何 让 goroutine 并 行 运 行 。 代 
码 清 单 6-1 所 示 的 程序 会 创建 两 个 goroutine， 以 并 发 的 形式 分 别 显 示 大 写 和 小 写 的 英文 字母 。 





代码 清单 6-1 listing01.go 


01 // 这 个 示例 程序 展示 如 何 创建 goroutine 
02 // 以 及 调度 器 的 行为 


03 Package main 











04 

05 import ( 

06 "fmt 

07 "runtime" 
08 "sync" 
09 ) 

10 


11 // main 是 所 有 Go 程序 的 入 口 


func main() { 
// 分 配 一 个 逻辑 处 理 器 给 调度 器 使 
runtime.GOMAXPROCS (1) 






































// wg 用 来 等 待 程序 完成 
// 计数 加 2， 表 示 要 等 待 两 个 goroutine 
Var wg Sync.WaitGroup 



































































































































下 9 wg.Add (2) 

20 

2 让 fmt.Println("Start Goroutines") 

22 

23 // 声明 一 个 匿名 函数 ， 并 创建 一 个 goroutine 

24 go fnNe (su 

25 // 在 函数 退出 时 调用 Done 来 通知 main 函数 工作 已 经 完成 
26 defer wg.Done() 

27 

28 // 显示 字母 表 3 次 

29 for count 3#= 07 count -< 37 counti++ { 

30 for. har = "ay har < “Aart2607 Charttr -1 
31 Fmt ,Printf(t"se chary) 

32 } 

33 } 

34 }() 

35 

36 // 声明 一 个 匿名 函数 ， 并 创建 一 个 goroutine 

37 go func() { 

38 // 在 函数 退出 时 调用 Done 来 通知 main 函数 工作 已 经 完成 
39 defer wg.Done() 

40 

41 // 显示 字母 表 3 次 

42 for. count := OF CGO < 3 ‘Gountt+t+ { 

43 for char := 'A'; char < 'A'+26; char++ { 
44 fmts print f(t" Se ". Char) 

45 } 

46 } 

47 }() 

48 

49 // 等 待 goroutine 结束 

50 fmt.Printlin("Waiting To Finish") 

S31 wg .Wait () 

52 

53 fmt.Println("\nTerminating Program") 

54 } 


在 代码 清单 6-1 的 第 14 行 , 调用 了 runtime 包 的 GOMAXPROCS 也 数 。 这 个 函数 允许 程序 
更 改 调度 器 可 以 使 用 的 逻辑 处 理 器 的 数量 。 如 果 不 想 在 代码 里 做 这 个 调用 , 也 可 以 通过 修改 和 这 
个 函数 名 字 一 样 的 环境 变量 的 值 来 更 改 逻 辑 处 理 器 的 数量 。 给 这 个 函数 传人 1， 是 通知 调度 器 只 
能 为 该 程序 使 用 一 个 逻辑 处 理 器 。 

在 第 24 行 和 第 37 行 ， 我 们 声明 了 两 个 匿名 函数 ， 用 来 显示 英文 字母 表 。 第 24 行 的 函数 显 
示 小 写字 母 表 , 而 第 37 行 的 函数 显示 大 写字 母 表 。 这 两 个 函数 分 别 通过 关键 字 go 创建 goroutine 
来 执行 。 根据 代码 清单 6-2 中 给 出 的 输出 可 以 看 到 , 每 个 goroutine 执行 的 代码 在 一 个 逻辑 处 理 器 


























6.2 goroutine 127 


上 并 发 运行 的 效果 。 





代码 清单 6-2 listing01.go 的 输出 


Start Goroutines 
Waiting To Finish 


AB CDE FGH I KE MNO PORS TU VHRREYT ZABC DE ESGHLUKLNU 
NO-FEQRST VW XR YY 2B DE EG HI TRL MNO PY RS TU YR 
a bdef oh kL miro Bg rr St WU VW XY ZEBode fyi jk.L nm 
nO Dd ES VW Yb Cd hi TELmno pq rs.t my Wy 之 


Terminating Program 


第 一 个 goroutine 完成 所 有 显示 需要 花 时 间 太 短 了 ， 以 至 于 在 调度 器 切换 到 第 二 个 goroutine 
之 前 , 就 完成 了 所 有 任务 。 这 也 是 为 什么 会 看 到 先 输出 了 所 有 的 大 写字 母 , 之 后 才 输 出 小 写字 母 。 
我 们 创建 的 两 个 goroutine 一 个 接 一 个 地 并 发 运行 ， 独 立 完 成 显示 字母 表 的 任务 。 

如 代码 清单 6-3 所 示 , 一 旦 两 个 匿名 函数 创建 goroutine 来 执行 , main 中 的 代码 会 继续 运行 。 

这 意味 着 main 函数 会 在 goroutine 完成 工作 前 返回 。 如 果真 的 返回 了 ， 程 序 就 会 在 goroutine 有 
机 会 运行 前 终止 。 因 此 , 在 第 51 行 , main 函数 通过 WaitGroup, 等 待 两 个 goroutine 完成 它们 
的 工作 。 











代码 清单 6-3 listing01.go: 第 17 行 到 第 19 行 ， 第 23 行 到 第 26 行 ， 第 49 行 到 第 51 行 







































































16 // wg 用 来 等 待 程序 完成 

17 // 计数 加 2， 表 示 要 等 待 两 个 goroutine 

18 Var wg sync.WaitGroup 

19 wg.Add (2) 

23 // 声明 一 个 匿名 函数 ， 并 创建 一 个 goroutine 
24 go func() { 

25 // 在 函数 退出 时 调用 Done 来 通知 main 函数 工作 已 经 完成 
26 defer wg.Done() 

49 // 等 待 goroutine 结束 

50 fmt .Println("Waiting To Finish") 

51 wg .Wait() 





WaitGroup 是 一 个 计数 信号 量 , 可 以 用 来 记录 并 维护 运行 的 goroutine。 如 果 WaitGroup 
的 值 大 于 0，Wait 方法 就 会 阻塞 。 在 第 18 行 ， 创建 了 一 个 WaitGroup 类 型 的 变量 ， 之 后 在 
第 19 行将 这 个 WaitGroup 的 值 设 置 为 2， 表 示 有 两 个 正在 运行 的 goroutine。 为 了 减 小 
WaitGroup 的 值 并 最 终 释放 main 函数 ， 要 在 第 26 和 39 行 , 使 用 defez 声明 在 函数 退出 时 
调用 Done 方法 。 

关键 字 defer 会 修改 函数 调用 时 机 , 在 正在 执行 的 函数 返回 时 才 真正 调用 defer 声明 的 函 
数 。 对 这 里 的 示例 程序 来 说 ,我 们 使 用 关键 字 defer 保证 ， 每 个 goroutine 一 旦 完成 其 工作 就 调 
用 Done 方法 。 

基于 调度 器 的 内 部 算法 ， 一 个 正 运 行 的 goroutine 在 工作 结束 前 ， 可 以 被 停止 并 重新 调度 。 














调度 器 这 样 做 的 目的 是 防止 某 个 goroutine 长 时 间 占 用 逻辑 处 理 器 。 当 goroutine 占用 时 间 过 长 时 ， 
调度 器 会 停止 当前 正和 运行 的 goroutine ， 并 给 其 他 可 运行 的 goroutine 运行 的 机 会 。 

图 6-4 从 逻辑 处 理 器 的 角度 展示 了 这 一 场景 。 在 第 1 步 ， 调 度 器 开始 运行 goroutine A， 而 
goroutine B 在 运行 队列 里 等 待 调度 。 之 后 ， 在 第 2 步 ， 调 度 器 交换 了 goroutine A 和 goroutine B 。 
由 于 goroutine A 并 没有 完成 工作 ， 因 此 被 放 回 到 运行 队列 。 之 后 ， 在 第 3 步 ，goroutine B 完成 
了 它 的 工作 并 被 系统 销毁 。 这 也 让 goroutine A 继续 之 前 的 工作 。 


第 1 步 第 2 步 第 3 步 











图 6-4 goroutine 在 逻辑 处 理 器 的 线程 上 进行 交换 


可 以 通过 创建 一 个 需要 长 时 间 才 能 完成 其 工作 的 goroutine 来 看 到 这 个 行为 , 如 代码 清单 6-4 
所 示 。 





代码 清单 6-4 listing04.go 


01 // 这 个 示例 程序 展示 goroutine 调度 器 是 如 何在 单个 线程 上 
02 // 切 分 时 间 片 的 


03 Package main 











04 

05 import ( 

06 VEnit " 

07 "runtime" 
08 Veynie™ 
09 ) 

10 


// wg 用 来 等 待 程序 完成 


Var wg sync.WaitGroup 





// main 是 所 有 Go 程序 的 入 口 

func main() { 
// 分 配 一 个 逻辑 处 理 器 给 调度 器 使 
runtime.GOMAXPROCS (1) 























oo ~OOOU 必 wm 哺 

















19 // 计数 加 2， 表 示 要 等 待 两 个 goroutine 








20 wg.Adqd (2) 

21 

22 // 创建 两 个 goroutine 

23 fmt.Println("Create Goroutines") 
24 go printPrime ("A") 

25 go printPrime ("B") 

26 

2 // 等 待 goroutine 结束 

28 fmt.Println("Waiting To Finish") 
29 wg .Wait () 

30 

沪 主 fmt.Println("Terminating Program") 
32 } 

33 


34 // printPrime 显示 5000 以 内 的 素数 值 
35 func printPrime (prefix string) { 


36 // 在 函数 退出 时 调用 Done 来 通知 main 函数 工作 已 经 完成 
































过 天 defer wg.Done() 

38 

39 next: 

40 for outer := 2; outer < 5000; outer++ { 
41 for inner := 2; inner < outer; inner++ { 
42 if outersinner == 0 { 

43 continue next 

44 } 

45 } 

46 fmt.Printf("%s:%Sd\n", prefix, outer) 
47 } 

48 fmt.Println("Completed", prefix) 

49 } 


代码 清单 6-4 中 的 程序 创建 了 两 个 goroutine， 分 别 打印 1~5000 内 的 素数 。 查 找 并 显示 素数 
会 消耗 不 少时 间 ， 这 会 让 调度 器 有 机 会 在 第 一 个 goroutine 找到 所 有 素数 之 前 ， 切 换 该 goroutine 
的 时 间 片 。 

在 第 12 行 中 , 程序 启动 的 时 候 ， 声 明了 一 个 WaitGroup 变量 , 并 在 第 20 行将 其 值 设置 为 
2。 之 后 在 第 24 行 和 第 25 行 ， 在 关键 字 go 后 面 指定 printPrime 因数 并 创建 了 两 个 goroutine 
来 执行 。 第 一 个 goroutine 使 用 前 级 A， 第 二 个 goroutine 使 用 前 级 B。 和 其 他 函数 调用 一 样 ， 创 
建 为 goroutine 的 函数 调用 时 可 以 传人 参数 。 不 过 goroutine 终止 时 无 法 获取 函数 的 返回 值 。 查 看 
代码 清单 6-5 中 给 出 的 输出 时 ， 会 看 到 调度 器 在 切换 第 一 个 goroutine。 








代码 清单 6-5 listing04.go 的 输出 
Create Goroutines 
Waiting To Finish 
B22 
B:3 
B:4583 
B:4591 


3 xx 切换 goroutine 


DD 


A:4561 

A:4567 

B:4603 xx 切换 goroutine 
B:4621 

Completed B 

A:4457 ** 切换 goroutine 
A:4463 

A:4993 

A:4999 


Completed A 
Terminating Program 


goroutine B 先 显 示 素 数 。 一 旦 goroutine B 打印 到 素数 4591 ,调度 器 就 会 将 正 运行 的 goroutine 
切换 为 goroutine A。 之 后 goroutine A 在 线程 上 执行 了 一 段 时 间 ， 再 次 切换 为 goroutine B。 这 次 
goroutine B 完成 了 所 有 的 工作 。 一 旦 goroutine B 返回 ， 就 会 看 到 线程 再 次 切换 到 goroutine A 并 
完成 所 有 的 工作 。 每 次 运行 这 个 程序 ， 调 度 器 切换 的 时 间 点 都 会 稍微 有 些 不 同 。 

代码 清单 6-1 和 代码 清单 6-4 中 的 示例 程序 展示 了 调度 器 如 何在 一 个 逻辑 处 理 器 上 并 发 运行 
多 个 goroutine。 像 之 前 提 到 的 ，Go 标准 库 的 runtime 包 里 有 一 个 名 为 GOMAXPROCS 的 函数 ， 
通过 它 可 以 指定 调度 器 可 用 的 逻辑 处 理 器 的 数量 。 用 这 个 函数 , 可 以 给 每 个 可 用 的 物理 处 理 器 在 
运行 的 时 候 分 配 一 个 逻辑 处 理 器 。 代 码 清单 6-6 展示 了 这 种 改动 ， 让 goroutine 并 行 运行 。 




















代码 清单 6-6 ”如 何 修改 逻辑 处 理 器 的 数量 


import "runtime" 


// 给 每 个 可 用 的 核心 分 配 一 个 逻辑 处 理 器 

runtime.GOMAXPROCS (runtime.NumCPU ()) 

包 runtime 提供 了 修改 Go 语言 运行 时 配置 参数 的 能 力 。 在 代码 清单 6-6 里 ， 我 们 使 用 两 
个 runtime 包 的 函数 来 修改 调度 器 使 用 的 逻辑 处 理 带 的 数量 。 函数 NumcPU 返回 可 以 使 用 的 物 
理 处 理 器 的 数量 。 因 此 ,调用 GOMAXPROCS 函数 就 为 每 个 可 用 的 物理 处 理 器 创建 一 个 逻辑 处 理 
器 。 需 要 强调 的 是 , 使 用 多 个 逻辑 处 理 器 并 不 意味 着 性 能 更 好 。 在 修改 任何 语言 运行 时 配置 参数 
的 时 候 ， 都 需要 配合 基准 测试 来 评估 程序 的 运行 效果 。 

如 果 给 调度 器 分 配 多 个 逻辑 处 理 器 , 我 们 会 看 到 之 前 的 示例 程序 的 输出 行为 会 有 些 不 同 。 让 
我 们 把 逻辑 处 理 器 的 数量 改 为 2, 并 再 次 运行 第 一 个 打印 英文 字母 表 的 示例 程序 , 如 代码 清单 6-7 
所 示 。 


代码 清单 6-7 listing07.go 


01 // 这 个 示例 程序 展示 如 何 创建 goroutine 
























































02 // 以 及 goroutine 调度 器 的 行为 


03 package main 







































































































































































04 

05 import ( 

06 Vfmt" 

07 "runtime" 

08 Veyne" 

09 ) 

10 

11 // main 是 所 有 Go 程序 的 入 

12 func main() { 

13 // 分 配 2 个 逻辑 处 理 器 给 调度 器 使 用 

14 runtime .GOMAXPROCS (2) 

15 

16 // wg 用 来 等 待 程序 完成 

于 了 // 计数 加 2， 表 示 要 等 待 两 个 goroutine 

18 Var wg sync.WaitGroup 

1:9 wg.Add (2) 

20 

21 fmt.Println("Start Goroutines") 

22 

23 // 声明 一 个 匿名 函数 ， 并 创建 一 个 goroutine 

24 go func() { 

25 // 在 函数 退出 时 调用 Done 来 通知 main 函数 工作 已 经 完成 
26 defer wg.Done() 

2.7 

28 // 显示 字母 表 3 次 

29 fOr Count := OF count < 3 Count++ 并 
30 for char := 'a'; char < 'a'+26; char++ { 
过 二 fmt Printf ("se ", char) 

32 } 

33 } 

34 }() 

35 

36 // 声明 一 个 匿名 函数 ， 并 创建 一 个 goroutine 

3 这 go func() { 

38 // 在 函数 退出 时 调用 Done 来 通知 main 函数 工作 已 经 完成 
39 defer wg.Done() 

40 

41 // 显示 字母 表 3 次 

42 for econt 3= OF ‘count «< 3 "COUunNt++ 二 
43 for char := 'A'; char < 'A'+26; char++ { 
44 fmt Printf{("Se "} Shary} 

45 } 

46 } 

47 }() 

48 

49 // 等 待 goroutine 结束 

50 fmt.Printlin("Waiting To Finish") 

51 wg .Wait () 

52 

53 fmt.Println("\nTerminating Program") 


代码 清单 6-7 中 给 出 的 例子 在 第 14 行 中 通过 调用 GOMAXPROCS 函数 创建 了 两 个 逻辑 处 理 需 。 
这 会 让 goroutine 并 行 运行 ， 输 出 结果 如 代码 清单 6-8 所 示 。 


代码 清单 6-8 listing07.go 的 输出 


Create Goroutines 
Waiting To Finish 


ABCaDEbFcGdHeIlf JgrKrhLiMjNKkEkOlPmoOnRoSPpTI 
qqUrVvswtXxXuYvZzwAxByCzDaEbrFcGdHeIlf JgrKhLl 
TM- TIT Nk OO 1 PmoO HRO SPLq Ur Vs Wt XY VLw AX BYCzD 
aEbFcGdHeIf JgrKhnLiMjNKkOlPmQAOnRoSpTqUry 
Sy 


Terminating Program 

如 果 仔 细 查 看 代码 清单 6-8 中 的 输出 ， 会 看 到 goroutine 是 并 行 运 行 的 。 两 个 goroutine 几乎 
是 同时 开始 运行 的 ,大 小 写字 母 是 混合 在 一 起 显示 的 。 这 是 在 一 台 8 核 的 电脑 上 运行 程序 的 输出 ， 
所 以 每 个 goroutine 独自 运行 在 自己 的 核 上 。 记 住 ， 只 有 在 有 多 个 人 逻辑 处 理 器 且 可 以 同时 让 每 个 
goroutine 运行 在 一 个 可 用 的 物理 处 理 器 上 的 时 候 ，goroutine 才 会 并 行 运行 。 

现在 知道 了 如 何 创建 goroutine, 并 了 解 这 背后 发 生 的 事情 了 。 下 面 需要 了 解 一 下 写 并 发 程序 
时 的 潜在 危险 ， 以 及 需要 注意 的 事情 。 


























XX 竞争 状态 


如 果 两 个 或 者 多 个 goroutine 在 没有 互相 同步 的 情况 下 ,访问 某 个 共享 的 资源 ， 并 试图 同时 
读 和 写 这 个 资源 ， 就 处 于 相互 竞争 的 状态 ， 这 种 情况 被 称 作 竞争 状态 ( race candition ), 竞争 状态 
的 存在 是 让 并 发 程序 变 得 复杂 的 地 方 , 十 分 容易 引起 潜在 问题 。 对 一 个 共享 资源 的 读 和 写 操作 必 
须 是 原子 化 的 ， 换 名 话说 ， 同 一 时 刻 只 能 有 一 个 goroutine 对 共享 资源 进行 读 和 写 操作 。 代 码 清 
单 6.9 中 给 出 的 是 包含 竞争 状态 的 示例 程序 。 


代码 清单 6-9 listing09.go 
01 // 这 个 示例 程序 展示 如 何在 程序 里 造成 竞争 状态 
02 // 实际 上 不 希望 出 现 这 种 情况 


03 Package main 






































04 

05 import ( 

06 Emi 

07 "runtime" 
08 Vsyneu 

09 ) 

10 

11 Var ( 

玉 // counter 是 所 有 goroutine 都 要 增加 其 值 的 变量 
13 counter int 
14 





上 // wg 用 来 等 待 程序 结束 


16 wg sync.WaitGroup 























和 

18 

19 // main 是 所 有 Go 程序 的 入 口 

20 func main() { 

21 // 计数 加 2， 表示 要 等 待 两 个 goroutine 
22 wg.Add (2) 

23 

24 // 创建 两 个 goroutine 

25 go incCounter (1) 

26 go incCounter (2) 

27 

28 // 等 待 goroutine 结束 

29 wg .Wait () 

30 fmt.Println("Final Counter:", counter) 
3 

32 








33 // incCounter 增加 包 里 counter 变量 的 值 
34 func incCounter (id int) { 


35 // 在 函数 退出 时 调用 Done 来 通知 main 函数 工作 已 经 完成 






















































































36 defer wg.Done() 

号 了 

38 for count = OF count < 2 Count++ -{ 
39 // 捕获 counter 的 值 

40 value := counter 

41 

42 // 当前 goroutine 从 线程 退出 ， 并 放 回 到 队列 
43 runtime.Gosched () 

44 

45 // 增加 本 地 value 变量 的 值 

46 valuet+ 

47 

48 // 将 该 值 保存 回 counter 

49 counter = value 

50 } 

与 47 ,和 


对 应 的 输出 如 代码 清单 6-10 所 示 。 





代码 清单 6-10 ”listing09.go 的 输出 


Final Counter: 2 


变量 counter 会 进行 4 次 读 和 写 操作 ,每 个 goroutine 执行 两 次 ,但 是 ,程序 终止 时 ,counter 
变量 的 值 为 2。 图 6-5 提供 了 为 什么 会 这 样 的 线索 。 
每 个 goroutine 都 会 覆盖 另 一 个 goroutine 的 工作 。 这 种 有 覆盖 发 生 在 goroutine 的 时 候 。 每 
个 goroutine 创造 了 一 个 counter 变量 的 副本 , 之 后 就 切换 到 另 一 个 goroutine。 当 这 个 goroutine 


























再 次 运行 的 时 候 ，countet 变量 的 值 已 经 改变 了 , 但 是 goroutine 并 没有 更 新 自 1 本 的 
值 ， 而 是 继续 使 用 这 个 副本 的 值 ， 用 这 个 值 递增 ， 并 存 回 counter 变量 ,结果 覆盖 了 男 一 个 
goroutine 完成 的 工作 。 





























incCounter(D) | | incCounter(2) 


| 读 取 counter 值 
切换 线程 
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counter ! 写 入 counter 值 
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图 6-5 ”竞争 状态 下 程序 行为 的 图 像 表 达 


让 我 们 顺 着 程序 理解 一 下 发 生 了 什么 。 在 第 25 行 和 第 26 行使 用 ijnccounter 函数 创建 
了 两 个 goroutine。 在 第 34 行 ， ijncCounter 函数 对 包 内 变量 counter 进行 了 读 和 写 操作 ， 而 
这 个 变量 是 这 个 示例 程序 里 的 共享 资源 。 每 个 goroutine 都 会 先 读 出 这 个 counter 变量 的 值 , 并 
在 第 40 行将 counter 变量 的 副本 存 入 一 个 叫 作 value 的 本 地 变量 。 之 后 在 第 46 行 ， 
incCounter 玉 数 对 value 的 副本 的 值 加 1 ,最 终 在 第 49 行将 这 个 新 值 存 回 到 counter 变量 。 
这 个 函数 在 第 43 行 调用 了 runtime 包 的 Gosched 因数 ， 用 于 将 goroutine 从 当前 线程 退出 ， 
给 其 他 goroutine 运行 的 机 会 。 在 两 次 操作 中 间 这 样 做 的 目的 是 强制 调度 器 切换 两 个 goroutine， 
以 便 让 竞争 状态 的 效果 变 得 更 明显 。 

Go 语言 有 一 个 特别 的 工具 ， 可 以 在 代码 里 检测 竞争 状态 。 在 查找 这 类 错误 的 时 候 ， 这 个 工 
具 非 常 好 用 , 尤其 是 在 竞争 状态 并 不 像 这 个 例子 里 这 么 明显 的 时 候 。 让 我 们 用 这 个 竞争 检测 器 来 
检测 一 下 我 们 的 例子 代码 ， 如 代码 清单 6-11 所 示 。 









































代码 清单 6-11 ”用 竞争 检测 器 来 编译 并 执行 listing09 的 代码 











go build -race // 用 竞争 检测 器 标志 来 编译 程序 








./example // 运行 程序 








WARNING: DATA RACE 
Write by goroutine 5: 


main.incCounter () 
/example/main.go:49 +0x96 


Previous read by goroutine 6: 
main.incCounter() 
/example/main.go:40 +0x66 


Goroutine 5 (running) created at: 
main.main() 
/example/main.go:25 +0x5c 


Goroutine 6 (running) created at: 
main.main() 
/example/main.go:26 +0x73 








Final Counter: 2 
Found 1 data race(s) 


代码 清单 6-11 中 的 苋 争 检测 需 指 出 这 个 例子 里 面 代 码 清单 6-12 所 示 的 4 行 代码 有 问题 。 





代码 清单 6-12 ”竞争 检测 器 指出 的 代码 


Line 49: counter = value 

Line 40: value := counter 
Line 25: go incCounter (1) 
Line 26: go incCounter (2) 


代码 清单 6-12 展示 了 竞争 检测 器 查 到 的 哪个 goroutine 引发 了 数据 竞争 ， 以 及 哪 两 行 代 码 有 
冲突 。 毫 不 奇怪 ， 这 几 行 代码 分 别 是 对 counter 变量 的 读 和 写 操作 。 

一 种 修正 代码 、 消 除 竞争 状态 的 办 法 是 ， 使 用 Go 语言 提供 的 锁 机 制 ， 来 锁 住 共享 资源 ， 从 
而 保证 goroutine 的 同步 状态 。 


XW 锁 住 共 享 资源 


Go 语言 提供 了 传统 的 同步 goroutine 的 机 制 ， 就 是 对 共享 资源 加 锁 。 如 果 需 要 顺序 访问 一 个 
整 型 变量 或 者 一 段 代 码 ，atomic 和 sync 包 里 的 函数 提供 了 很 好 的 解决 方案 。 下 面 我 们 了 解 一 
下 atomic 包 里 的 几 个 函数 以 及 sync 包 里 的 mutex 类 型 。 





6.4.1 原子 函数 


原子 函数 能 够 以 很 底层 的 加 锁 机 制 来 同步 访问 整 型 变量 和 指针 。 我们 可 以 用 原子 函数 来 修正 
代码 清单 6-9 中 创建 的 竞争 状态 ， 如 代码 清单 6-13 所 示 。 





代码 清单 6-13 listing13.go 


01 
02 
03 
04 
05 
06 
07 
08 
09 





35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 








// 这 个 示例 程序 展示 如 何 使 用 atomic 包 来 提供 





// 对 数值 类 型 的 安全 访问 


Package main 


import ( 
TY fmt bk 
"runtime" 
时 sync TY 
"sync/atomic" 


var ( 














// counter 是 所 有 goroutine 都 要 增加 其 值 的 变量 


Counter int64 


// wg 用 来 等 待 程序 结束 


wg sync.WaitGroup 





) 


// main 是 所 有 Go 程序 的 入 口 


func main() { 





// 计数 加 2， 表示 要 等 待 两 个 goroutine 


wg .Add (2) 





// 创建 两 个 goroutine 
go incCounter (1) 
go incCounter (2) 





// 等 待 goroutine 结束 
wg .Wait () 


// 显示 最 终 的 值 





fmt.Println("Final Counter:", 


} 





// incCounter 增加 包 里 counter 变量 的 值 








func incCounter (id int) { 




















counter) 











// 在 函数 退出 时 调用 Done 来 通知 main 函数 工作 已 经 完 
defer wg.Done() 
for count := Us count < 2 CO 七 十 十 
// 安全 地 对 counter 加 1 
atomic.AddIint64(&counter, 1) 
// 当前 goroutine 从 线程 退出 ， 并 放 回 到 队列 








runtime.Gosched() 


} 


对 应 的 输出 如 代码 清单 6-14 所 示 。 





代码 清单 6-14 listing13.go 的 输出 

Final Counter: 4 

现在 , 程序 的 第 43 行使 用 了 atmoic 包 的 AddInt 64 函数 。 这 个 函数 会 同步 整 型 值 的 加 法 ， 
方法 是 强制 同一 时 刻 只 能 有 一 个 goroutine 运行 并 完成 这 个 加 法 操作 。 当 goroutine 试图 去 调用 任 
何 原子 函数 时 ， 这 些 goroutine 都 会 自动 根据 所 引用 的 变量 做 同步 处 理 。 现 在 我 们 得 到 了 正确 的 
值 4。 

男 外 两 个 有 用 的 原子 函数 是 LoadInt64 和 StoreInt64。 这 两 个 函数 提供 了 一 种 安全 地 读 
和 写 一 个 整 型 值 的 方式 。 代 码 清单 6-15 中 的 示例 程序 使 用 LoadInt64 和 StoreInt64 来 创建 
一 个 同步 标志 ， 这 个 标志 可 以 向 程序 里 多 个 goroutine 通知 某 个 特殊 状态 。 


代码 清单 6-15 listing15.go 


01 // 这 个 示例 程序 展示 如 何 使 用 atomic 包 里 的 
02 // Store 和 Load 类 函数 来 提供 对 数值 类 型 
03 // 的 安全 访问 

04 Package main 



















































































05 

06 import ( 

07 生地 在 

08 vesyriey 

09 "sync/atomic" 

10 "time" 

) 

2 

SEE 

14 // shutdown 是 通知 正在 执行 的 goroutine 停止 工作 的 标志 
15 shutdown int64 

6 

了 // wg 用 来 等 待 程序 结束 

18 wg sync.WaitGroup 

L909. ) 
20 
21 // main 是 所 有 Go 程序 的 入 口 
22 func main() { 
23 // 计数 加 2， 表示 要 等 待 两 个 goroutine 
24 wg.Add (2) 
25 
26 // 创建 两 个 goroutine 
27 go doWork ("A") 
28 go doWork ("B") 
29 
30 // 给 定 goroutine 执行 的 时 间 
3 下 time.Sleep(1 * time.Second) 
32 
33 // 该 停止 工作 了 ， 安 全 地 设置 shut down 标志 
34 fmt.Println("Shutdown Now") 
35 atomic.StoreInt64(&shutdown, 1) 





37 // 等 待 goroutine 结束 


















































38 wg .Wait () 

39. 

40 

41 // doWork 用 来 模拟 执行 工作 的 goroutine， 

42 // 检测 之 前 的 shutqdown 标志 来 决定 是 否 提 前 终止 

43 func doWork (name string) { 

44 // 在 函数 退出 时 调用 Done 来 通知 main 函数 工作 已 经 完 
45 defer wg.Done() 

46 

47 | 

48 fmt.Printf ("Doing %s Work\n", name) 

49 time.Sleep(250 * time.Millisecond) 

50 

51 // 要 停止 工作 了 吗 ? 

52 if atomic.LoadIint64(&shutdown) == 1 { 
53 fmt.Printf ("Shutting %s Down\n", name) 
54 break 

5 } 

56 } 

吉 下 年 


在 这 个 例子 中 , 启动 了 两 个 goroutine， 并 完成 一 些 工作 。 在 各 自 循环 的 每 次 扩 代 之 后 ,在 第 
52 行 中 goroutine 会 使 用 LoadInt64 来 检查 shutdown 变量 的 值 。 这 个 函数 会 安全 地 返回 
shut down 变量 的 一 个 副本 。 如 果 这 个 副本 的 值 为 1，goroutine 就 会 跳出 循环 并 终止。 

在 第 35 行 中 , main 函数 使 用 StoreInt64 函数 来 安全 地 修改 shut down 变量 的 值 。 如 果 
哪个 doWork goroutine 试图 在 main 孙 数 调用 StoreInt64 的 同时 调用 LoadInt64 函数 ， 那 
么 原子 孔 数 会 将 这 些 调用 互相 同步 ， 保 证 这 些 操作 都 是 安全 的 ， 不 会 进入 竞争 状态 。 





6.4.2 互 斥 锁 


另 一 种 同步 访问 共享 资源 的 方式 是 使 用 互 斥 锁 (mutex ), 互 斥 锁 这 个 名 字 来 自 互 斥 ( mutual 
exclusion ) 的 概念 。 互 斥 锁 用 于 在 代码 上 创建 一 个 临界 区 , 保证 同一 时 间 只 有 一 个 goroutine 可 以 
执行 这 个 临界 区 代码 。 我 们 还 可 以 用 互 斥 锁 来 修正 代码 清单 6-9 中 创建 的 竞争 状态 ， 如 代码 清单 
6-16 所 示 。 


代码 清单 6-16 listing16.go 


01 // 这 个 示例 程序 展示 如 何 使 用 互 斥 锁 来 
02 // 定义 一 段 需要 同步 访问 的 代码 临界 区 
03 // 资源 的 同步 访问 


04 package main 

















05 

06 import ( 

07 "fmt™ 

08 "runtime" 
09 "sync" 


var 


ew J nt 





21 ) 


23 // main 是 所 有 Go 程序 的 入 口 


24 func main() 


35 中 


( 





counter int 


A 

















wg 用 来 等 待 程序 结束 





wg sync.WaitGroup 


// mutex 














来 定义 一 段 代码 临界 区 





Xx 








mutex sync.Mutex 


VA 


wg. 


// 


wg. 


计数 加 
Add (2 





{ 
2， 表 示 要 等 待 两 个 gorout ine 

















) 








创建 两 个 goroutine 
incCounter (1) 
incCounter (2) 


等 待 goroutine 结束 


Wait( 


) 


// counter 是 所 有 goroutine 都 要 增加 其 值 的 变量 


fmt.Printf("Final Counter: Sd\\n", counter) 











37 // incCounter 使 用 互 斥 锁 来 同步 并 保证 安全 访问 ， 


38 // 增加 包 是 











有 counter 变量 的 值 











39 func incCounterl(id int) { 


6 






































在 函数 退出 时 调用 Done 来 通知 main 函数 工作 








已 经 完成 





defer wg.Done() 























for COUunt :3 QF .COUunt < 2 COUNnt++t+ 4 
// 同一 时 刻 只 允许 一 个 goroutine 进入 
// 这 个 临界 区 
mutex.Lock () 


{ 


} 


mute 








// 捕获 counter 的 值 
value := counter 











// 当前 goroutine 从 线程 退出 ， 并 放 








I 








runtime.Gosched() 


// 增加 本 地 value 变量 的 值 


valuet++ 











// 将 该 值 保存 回 counter 
counter = value 





x.Unlock () 





// 释放 锁 ， 人 允许 其 他 正在 等 待 的 goroutine 

















进入 临界 区 





4 


到 队列 


对 counter 变量 的 操作 在 第 46 行 和 第 60 行 的 Lock () 和 Unlock () 函数 调用 定义 的 临界 
区 里 被 保护 起 来 。 使 用 大 括号 只 是 为 了 让 临界 区 看 起 来 更 清晰 ， 并 不 是 必需 的 。 同 一 时 刻 只 有 
个 goroutine 可 以 进入 临界 区 。 之 后 ， 直 到 调用 Unlock () 函数 之 后 ， 其 他 goroutine 才能 进入 临 
界 区 。 当 第 52 行 强制 将 当前 goroutine 退出 当前 线程 后 , 调度 器 会 再 次 分 配 这 个 goroutine 继续 运 
行 。 当 程序 结束 时 ， 我 们 得 到 正确 的 值 4， 竞 争 状态 不 再 存在 。 





XX 通道 


原子 函数 和 互 斥 锁 都 能 工作 , 但 是 依靠 它们 都 不 会 让 编写 并 发 程序 变 得 更 简单 ,， 更 不 容易 出 
错 , 或 者 更 有 趣 。 在 Go 语言 里 ， 你 不 仅 可 以 使 用 原子 函数 和 互 斥 锁 来 保证 对 共享 资源 的 安全 访 
问 以 及 消除 竞争 状态 ， 还 可 以 使 用 通道 ， 通 过 发 送 和 接收 需要 共享 的 资源 ， 在 goroutine 之 间 做 
同步 。 

当 一 个 资源 需要 在 goroutine 之 间 共 享 时 ， 通 道 在 goroutine 之 间架 起 了 一 个 管道 ， 并 提供 了 
确保 同步 交换 数据 的 机 制 。 声明 通道 时 , 需要 指定 将 要 被 共享 的 数据 的 类 型 。 可 以 通过 通道 共享 
内 置 类 型 、 命 名 类 型 、 结 构 类 型 和 引用 类 型 的 值 或 者 指针 。 

在 Go 语言 中 需要 使 用 内 置 阴 数 make 来 创建 一 个 通道 ， 如 代码 清单 6-17 所 示 。 


代码 清单 6-17 使 用 make 创建 通道 


// 无 缓冲 的 整 型 通道 


unbuffered := make (chan int) 


























// 有 缓冲 的 字符 串通 道 

buffered := make (chan string, 10) 

在 代码 清单 6-17 中 ， 可 以 看 到 使 用 内 置 函数 make 创建 了 两 个 通道 ， 一 个 无 缓冲 的 通道 ， 
一 个 有 缓冲 的 通道 。make 的 第 一 个 参数 需要 是 关键 字 chan， 之 后 跟着 允许 通道 交换 的 数据 的 
类 型 。 如 果 创 建 的 是 一 个 有 缓冲 的 通道 ,之 后 还 需要 在 第 二 个 参数 指定 这 个 通道 的 缓冲 区 的 大 小 。 

向 通道 发 送 值 或 者 指针 需要 用 到 <- 操 作 符 ， 如 代码 清单 6-18 所 示 。 


代码 清单 6-18 ”向 通道 发 送 值 


// 有 缓冲 的 字符 串通 道 
buffered := make(chan string, 10) 










































































// 通过 通道 发 送 一 个 字符 串 

buffered <- "Gopher" 

在 代码 清单 6-18 里 ， 我 们 创建 了 一 个 有 缓冲 的 通道 ， 数 据 类 型 是 字符 串 ， 包 含 一 个 10 个 值 
的 缓冲 区 。 之 后 我 们 通过 通道 发 送 字 符 串 "Gopher"。 为 了 让 男 一 个 goroutine 可 以 从 该 通道 里 接 
收 到 这 个 字符 串 ， 我 们 依旧 使 用 <- 操 作 符 ， 但 这 次 是 一 元 运算 符 ， 如 代码 清单 6-19 所 示 。 




















代码 清单 6-19 ”从 通道 里 接收 值 
// 从 通道 接收 一 个 字符 串 
Value := <-buffered 
当 从 通道 里 接收 一 个 值 或 者 指针 时 , <- 运 算 符 在 要 操作 的 通道 变量 的 左 侧 , 如 代码 清单 6-19 
所 示 。 
通道 是 否 带 有 缓冲 ,其 行为 会 有 一 些 不 同 。 理 解 这 个 差异 对 决定 到 底 应 该 使 用 还 是 不 使 用 组 
冲 很 有 帮助 。 下 面 我 们 分 别 介绍 一 下 这 两 种 类 型 。 








6.5.1 无 缓冲 的 通道 


无 缓冲 的 通道 (unbuffered channel ) 是 指 在 接收 前 没有 能 力 保存 任何 值 的 通道 。 这 种 类 型 的 通 
道 要 求 发 送 goroutine 和 接收 goroutine 同时 准备 好 ,才能 完成 发 送 和 接收 操作 。 如 果 两 个 goroutine 
没有 同时 准备 好 ， 通 道 会 导致 先 执行 发 送 或 接收 操作 的 goroutine 阻塞 等 待 。 这 种 对 通道 进行 发 送 
和 接收 的 交互 行为 本 身 就 是 同步 的 。 其 中 任意 一 个 操作 都 无 法 离开 另 一 个 操作 单独 存在 。 

在 图 6-6 里 ， 可 以 看 到 一 个 例子 ， 展 示 两 个 goroutine 如 何 利用 无 缓冲 的 通道 来 共享 一 个 值 。 











通道 通道 
[ 1 
1 2 
goroutine goroutine goroutine goroutine 
通道 
@© 3 
3 
goroutine goroutine goroutine goroutine 
通道 通道 
1 [| 
5 6 
goroutine goroutine goroutine goroutine 








图 6-6 ”使 用 无 缓冲 的 通道 在 goroutine 之 间 同 步 


在 第 1 步 ， 两 个 goroutine 都 到 达 通 道 ， 但 哪个 都 没有 开始 执行 发 送 或 者 接收 。 在 第 2 步 ， 左 侧 
的 goroutine 将 它 的 手 伸 进 了 通道 ， 这 模拟 了 向 通道 发 送 数据 的 行为 。 这 时 ， 这 个 goroutine 会 在 
通道 中 被 锁 住 ， 直 到 交换 完成 。 在 第 3 步 ， 右 侧 的 goroutine 将 它 的 手 放 入 通道 ， 这 模拟 了 从 通 
道里 接收 数据 。 这 个 goroutine 一 样 也 会 在 通道 中 被 锁 住 ， 直 到 交换 完成 。 在 第 4 步 和 第 5 步 ， 
进行 交换 ， 并 最 终 ， 在 第 6 步 ， 两 个 goroutine 都 将 它们 的 手 从 通道 里 拿 出 来 ， 这 模拟 了 被 锁 住 
的 goroutine 得 到 释放 。 两 个 goroutine 现在 都 可 以 去 做 别 的 事情 了 。 

为 了 讲 得 更 清楚 ， 让 我 们 来 看 两 个 完整 的 例子 。 这 两 个 例子 都 会 使 用 无 缓冲 的 通道 在 两 个 
goroutine 之 间 同 步 交 换 数 据 。 

在 网 球 比赛 中 ， 两 位 选手 会 把 球 在 两 个 人 之 间 来 回 传 递 。 选 手 总 是 处 在 以 下 两 种 状态 之 一 : 
要 么 在 等 待 接 球 ， 要 么 将 球 打 向 对 方 。 可 以 使 用 两 个 goroutine 来 模拟 网 球 比 赛 ， 并 使 用 无 缓冲 
的 通道 来 模拟 球 的 来 回 ， 如 代码 清单 6-20 所 示 。 


代码 清单 6-20 listing20.go 
01 // 这 个 示例 程序 展示 如 何 用 无 缓冲 的 通道 来 模拟 
02 // 2 个 goroutine 间 的 网 球 比赛 
03 package main 


















































04 

05 import ( 

06 fmt" 

07 "math/rand" 
08 SVG 

09 "time" 

10 ) 

















// wg 用 来 等 待 程 序 结束 
Var wg sync.WaitGroup 








rand.Seed (time.Now() .UnixNano() ) 


2 
3 
14 
二 95 £UnG: Tnit() 款 
6 
2 
8 





19 // main 是 所 有 Go 程序 的 入 口 









































20 func main() { 

2 下 // 创建 一 个 无 缓冲 的 通道 

22 court := make (chan int) 

23 

24 // 计数 加 2， 表示 要 等 待 两 个 goroutine 
25 wg.Add (2) 

26 

27 // 启动 两 个 选手 

28 go player ("Nadal", court) 

29 go player ("Djokovic", court) 
30 

3 // 发 球 

32 Court: <=1 

33 





35 wg.Wait () 


38 // player 模拟 一 个 选手 在 打 网 球 


39 func player (name string, court chan int) { 





































































































40 // 在 函数 退出 时 调用 Done 来 通知 main 函数 工作 已 经 完 
41 defer wg.Done() 

42 

43 ee | 

44 / 等 待 球 被 击 打 过 来 

45 ballr ok i="<=00urt 

46 二 EGR 

47 // 如 果 通 道 被 关闭 ， 我 们 就 赢 了 

48 fmt.Printf ("Player %s Won\n", name) 
49 return 

50 } 

3 

52 // 选 随机 数 ， 然 后 用 这 个 数 来 判断 我 们 是 否 丢 球 
53 n := rand.Intn(100) 

54 if ngsl3 == 0 { 

55 fmt.Printf ("Player %s Missed\n", name) 
56 

57 // 关闭 通道 ， 表 示 我 们 输 了 

58 close (court) 

59 return 

60 } 

61 

62 // 显示 击 球 数 ， 并 将 击 球 数 加 1 

63 fmt.Printf ("Player %s Hit Sd\n", name, ball) 
64 ballt++ 

65 

66 // 将 球 打 向 对 手 

67 court <- ball 

68 } 

695 下 


这 个 程序 会 得 到 代码 清单 6-21 所 示 的 输出 。 


代码 清单 6-21 listing20.go 的 输出 





Player Nadal Hit 1 
Player Djokovic Hit 2 
Player Nadal Hit 3 
Player Djokovic Missed 
Player Nadal Won 


在 main 孙 数 的 第 22 行 , 创建 了 一 人 int 类 型 的 无 缓冲 的 通道 , 让 两 个 goroutine 在 击 球 时 
能 够 互相 同步 。 之 后 在 第 28 行 和 第 29 行 , 创建 了 参与 比赛 的 两 个 goroutine。 在 这 个 时 候 ， 两 个 
goroutine 都 阻塞 住 等 待 击 球 。 在 第 32 行 ， 将 球 发 到 通道 里 ， 程 序 开始 执行 这 个 比赛 ， 直 到 某 个 
goroutine 输 掉 比赛 。 

在 player 限 数 里 , 在 第 43 行 可 以 找到 一 个 无 限 循 环 的 for 语句 。 在 这 个 循环 里 ， 是 玩 游 
戏 的 过 程 。 在 第 45 行 ，goroutine 从 通道 接收 数据 ， 用 来 表示 等 待 接 球 。 这 个 接收 动作 会 锁 住 


goroutine ， 直 到 有 数据 发 送 到 通道 里 。 通 道 的 接收 动作 返回 时 ， 第 46 行 会 检测 ok 标志 是 否 为 
false。 如 果 这 个 值 是 false， 表 示 通 道 已 经 被 关闭 ， 游 戏 结束 。 在 第 53 行 到 第 60 行 ， 会 产 
生 一 个 随机 数 ， 用 来 决定 goroutine 是 否 击 中 了 球 。 如 果 击 中 了 球 , 在 第 64 行 ball 的 值 会 递增 
1, 并 在 第 67 行 将 ball 作为 球 重新 放 人 通道 , 发 送 给 另 一 位 选手 。 在 这 个 时 刻 , 两 个 goroutine 
都 会 被 锁 住 ， 直 到 交换 完成 。 最 终 ， 某 个 goroutine 没有 打 中 球 , 在 第 58 行 关闭 通道 。 之 后 两 个 
goroutine 都 会 返回 ， 通 过 defer 声明 的 Done 会 被 执行 ， 程 序 终止 。 

另 一 个 例子 ， 用 不 同 的 模式 ， 使 用 无 缓冲 的 通道 ， 在 goroutine 之 间 同 步 数 据 ， 来 模拟 接力 
比赛 。 在 接力 比赛 里 ，4 个 跑步 者 围绕 赛 道 轮流 跑 ( 如 代码 清单 6-22 所 示 )。 第 二 个 、 第 三 个 和 
第 四 个 跑步 者 要 接 到 前 一 位 跑步 者 的 接力 棒 后 才能 起 跑 。 比 赛 中 最 重要 的 部 分 是 要 传递 接力 棒 ， 
要 求 同 步 传递 。 在 同步 接力 棒 的 时 候 ， 参 与 接力 的 两 个 跑步 者 必须 在 同一 时 刻 准备 好 交接 。 


代码 清单 6-22 listing22.go 


// 这 个 示例 程序 展示 如 何 用 无 缓冲 的 通道 来 模拟 
// 4 个 goroutine 间 的 接力 比赛 


Package main 


01 
02 





AD 

















Import ( 
TY Ft TY 
TY sync TY 
"time" 


) 



































// wg 用 来 等 





待 程序 结束 


Var wg Sync.WaitGroup 


// main 是 所 有 Go 程序 的 入 口 


func main() { 














// 创建 一 个 无 缓冲 的 通道 


baton 


// 为 最 


wg.Add (1) 


// 第 一 








:= make (chan int) 


后 一 位 跑步 者 将 计数 加 1 








立 跑 步 者 持 有 接力 棒 


go Runner (baton) 





// 开始 


比赛 


aa 上 en *= + 


// 等 竺 








比赛 结束 


wg .Wait () 


} 


// Runner 模拟 接力 比赛 中 的 一 位 跑步 者 
func Runner(baton chan int) { 
Var newRunner int 


6.5 通道 


























36 // 等 待 接 力 棒 

3 runner := <-baton 

38 

39 // 开始 绕 着 跑道 跑步 

40 fmt.Printf ("Runner %d Running With Baton\n", runner) 
41 

42 // 创建 下 一 位 跑步 者 

43 if runner != 4 { 

44 newRunner = runner + 1 

45 fmt.Printf ("Runner %d To The Line\n", newRunner) 
46 go Runner (baton) 

47 j 

48 

49 // 围绕 跑道 跑 

50 time.Sleep(100 * time.Millisecond) 

51 

52 // 比赛 结 束 了 吗 ? 

53 if runner == 4 { 

54 fmt.Printf ("Runner %d Finished, Race Over\n", runner) 
:5 wg.Done () 

56 return 

sy } 

8 

59 // 将 接力 棒 交 给 下 一 位 跑步 者 

60 fmt.Printf ("Runner %d Exchange With Runner gsqNn"y 

61 runner, 

62 newRunner) 

63 

64 baton <- newRunner 

65 } 


运行 这 个 程序 会 得 到 代码 清单 6-23 所 示 的 输出 。 


代码 清单 6-23 listing22.go 的 输出 





Runner 1 Running With Baton 
Runner 1 To The Line 

Runner 1 Exchange With Runner 2 
Runner 2 Running With Baton 
Runner 2 To The Line 

Runner 2 Exchange With Runner 3 
Runner 3 Running With Baton 
Runner 3 To The Line 

Runner 3 Exchange With Runner 4 
Runner 4 Running With Baton 

4 








RunneL Finished, Race Over 








145 


在 main 函数 的 第 17 行 ， 创 建 了 一 个 无 缓冲 的 int 类 型 的 通道 baton， 用 来 同步 传递 接力 棒 。 
在 第 20 行 ,我们 给 waitGroup 加 1, 这样 main 函数 就 会 等 最 后 一 位 跑步 者 跑步 结束 。 在 第 23 行 














创建 了 一 个 goroutine, 用 来 表示 第 一 位 跑步 者 来 到 跑道 。 之 后 在 第 26 行 , 将 接力 棒 交 给 











这 个 跑步 者 ， 


比赛 开始 。 最 终 ， 在 第 29 行 ，main 函数 阻塞 在 WaitGroup， 等 候 最 后 一 位 跑步 者 完成 比赛 。 
在 Runner goroutine 里 ， 可 以 看 到 接力 棒 baton 是 如 何在 跑步 者 之 间 传 递 的 。 在 第 37 行 ， 
goroutine 对 baton 通道 执行 接收 操作 ,表示 等 候 接力 棒 。 一 旦 接力 棒 传 了 进来 , 在 第 46 行 就 会 





创建 一 位 新 跑步 者 ， 准 备 接力 下 一 棒 ， 直 到 goroutine 是 第 四 个 跑步 者 。 在 第 50 行 ， 跑 步 者 围绕 
跑道 跑 100 ms。 在 第 55 行 , 如 果 第 四 个 跑步 者 完成 了 比赛 , 就 调用 Done , 将 waitGroup 减 1， 
之 后 goroutine 返回 。 如 果 这 个 goroutine 不 是 第 四 个 跑步 者 , 那么 在 第 64 行 , 接力 棒 会 交 到 下 一 
个 已 经 在 等 待 的 跑步 者 手 上 。 在 这 个 时 候 ，goroutine 会 被 锁 住 ， 直 到 交接 完成 。 

在 这 两 个 例子 里 , 我 们 使 用 无 缓冲 的 通道 同步 goroutine, 模拟 了 网 球 和 接力 赛 。 代码 的 流程 
与 这 两 个 活动 在 真实 世界 中 的 流程 完全 一 样 ,这 样 的 代码 很 容易 读 懂 。 现 在 知道 了 无 缓冲 的 通道 
是 如 何 工 作 的 ， 接 下 来 我 们 会 学 习 有 缓冲 的 通道 的 工作 方法 。 





6.5.2 ”有 缓冲 的 通道 


有 缓冲 的 通道 (buffered channel ) 是 一 种 在 被 接收 前 能 存储 一 个 或 者 多 个 值 的 通道 。 这 种 类 
型 的 通道 并 不 强制 要 求 goroutine 之 间 必 须 同时 完成 发 送 和 接收 。 通 道 会 阻塞 发 送 和 接收 动作 的 
条 件 也 会 不 同 。 只 有 在 通道 中 没有 要 接收 的 值 时 ,接收 动作 才 会 阻塞 。 只 有 在 通道 没有 可 用 缓冲 
区 容纳 被 发 送 的 值 时 , 发 送 动作 才 会 阻塞 。 这 导致 有 缓冲 的 通道 和 无 缓冲 的 通道 之 间 的 一 个 很 大 
的 不 同 : 无 缓冲 的 通道 保证 进行 发 送 和 接收 的 goroutine 会 在 同一 时 间 进 行 数据 交换 ; 有 缓冲 的 
通道 没有 这 种 保证 。 

在 图 6-7 中 可 以 看 到 两 个 goroutine 分 别 向 有 缓冲 的 通道 里 增加 一 个 值 和 从 有 缓冲 的 通道 里 移 
除 一 个 值 。 在 第 1 步 , 右 侧 的 goroutine 正在 从 通道 接收 一 个 值 。 在 第 2 步 , 右 侧 的 这 个 goroutine 
独立 完成 了 接收 值 的 动作 ， 而 左 侧 的 goroutine 正在 发 送 一 个 新 值 到 通道 里 。 在 第 3 步 ， 左 侧 的 
goroutine 还 在 向 通道 发 送 新 值 ， 而 右 侧 的 goroutine 正在 从 通道 接收 另外 一 个 值 。 这 个 步骤 里 的 
两 个 操作 有 既 不 是 同步 的 ， 也 不 会 互相 阻塞 。 最 后 ,在 第 4 步 ， 所 有 的 发 送 和 接收 都 完成 ， 而 通道 
里 还 有 几 个 值 ， 也 有 一 些 空间 可 以 存 更 多 的 值 。 


ein 

















通 


/MIX 











2 








goroutine goroutine goroutine goroutine 
通道 
ls 
4 
goroutine goroutine goroutine goroutine 





图 6-7 使 用 有 缓冲 的 通道 在 goroutine 之 间 同 步 数 据 








让 我 们 看 一 个 使 用 有 缓冲 的 通道 的 例子 ， 这 个 例子 管理 一 组 goroutine 来 接收 并 完成 工作 。 
有 缓冲 的 通道 提供 了 一 种 清晰 而 直观 的 方式 来 实现 这 个 功能 ， 如 代码 清单 6-24 所 示 。 


代码 清单 6-24 listing24.go 


01 // 这 个 示例 程序 展示 如 何 使 用 
02 // 有 缓冲 的 通道 和 固定 数目 的 
03 // goroutine 来 处 理 一 堆 工 作 


04 package main 










































































05 
06 import ( 
07 fmt ™ 
08 "math/rand" 
09 "sync" 
10 "time" 

1 ) 

2 

3 const ( 
14 numberGoroutines = 4 // 要 使 用 的 goroutine 的 数量 
15 taskLoad = 10 // 要 处 理 的 工作 的 数量 
6 ) 
下 学 

8 // wg 用 来 等 待 程序 完成 
19 var wg sync.WaitGroup 











21 // init 初始 化 包 ，Go 语言 运行 时 会 在 其 他 代码 执行 之 前 
22 // 优先 执行 这 个 函数 


t 







































































23. .fuUne. Enit (ty 十 

24 // 初始 化 随机 数 种 子 

25 rand.Seed (time.Now() .Unix()) 

26" 

1 

28 // main 是 所 有 Go 程序 的 入 口 

29 func main() { 

30 // 创建 一 个 有 缓冲 的 通道 来 管理 工作 

3 tasks := make (chan String taskLoad) 

32 

33 // 启动 goroutine 来 处 理工 作 

34 wg.Add (numberGoroutines) 

35 for gr := 1; gr <= numberGoroutines; gr++ { 
36 go worker (tasks, gr) 

37 # 

38 

39 // 增加 一 组 要 完成 的 工作 

40 for post := 1; post <= taskLoad; post++ { 
41 tasks <- fmt.Sprintf("Task : %d", post) 
42 } 

43 

44 // 当 所 有 工作 都 处 理 完 时 关闭 通道 

45 // 以 便 所 有 goroutine 退出 

46 close (tasks) 

47 


48 // 等 待 所 有 工作 完成 
49 wg .Wait () 


50 } 

51 

52 // worker 作为 goroutine 启动 来 处 理 
53 // 从 有 缓冲 的 通道 传 入 的 工作 


54 func worker (tasks chan string, worker int) { 







































































55 // 通知 函数 已 经 返回 

56 defer wg.Done() 

57 

58 for 

59 // 等 待 分 配 工作 

60 task, ok := <-tasks 

61 if lok { 

62 // 这 意味 着 通道 已 经 空 了 ， 并 且 已 被 关闭 

$3 fmt.Printf ("Worker: %d : Shutting Down\n", worker) 
64 return 

65 } 

66 

67 // 显示 我 们 开始 工作 了 

68 fmt.Printf ("Worker: %d : Started $s\n", worker, task) 
69 

70 // 随机 等 一 段 时 间 来 模拟 工作 

咏 说 sleep := rand.Int63n(100) 

72 time.Sleep(time.Duration(sleep) * time.Millisecond) 
3 

74 // 显示 我 们 完成 了 工作 

25 fmt.Printf ("Worker: %d : Completed %s\n", worker, task) 
76 } 

六 


运行 这 个 程序 会 得 到 代码 清单 6-25 所 示 的 输出 。 


代码 清单 6-25 listing24.9o 的 输出 











Worker: 1 Started Task : 1 
Worker: 2 Started Task 2 
Worker: 3 Started Task 3 
Worker: 4 Started Task : 4 
Worker: 1 Completed Task : 1 
Worker: 1 Started Task : 5 
Worker: 4 Completed Task : 4 
Worker: 4 Started Task : 6 
Worker: 1 Completed Task : 5 
Worker: 1 Started Task : 7 
Worker: 2 Completed Task : 2 
Worker: 2 Started Task : 8 
Worker: 3 Completed Task : 3 
Worker: 3 Started Task : 9 
Worker: 1 Completed Task : 7 
Worker: 1 Started Task : 10 
Worker: 4 Completed Task : 6 
Worker: 4 Shutting Down 
Worker: 3 Completed Task : 9 
Worker: 3 Shutting Down 
Worker: 2 Completed Task : 8 








Worker: 2 : Shutting Down 
Worker: 1 : Completed Task : 10 
Worker: 1 : Shutting Down 


由 于 程序 和 Go 语言 的 调度 器 带 有 随机 成 分 , 这 个 程序 每 次 执行 得 到 的 输出 会 不 一 样 。 不 过 ， 
通过 有 绥 冲 的 通道 ， 使 用 所 有 4 个 goroutine 来 完成 工作 ， 这 个 流程 不 会 变 。 从 输出 可 以 看 到 每 
个 goroutine 是 如 何 接收 从 通道 里 分 发 的 工作 。 

在 main 函数 的 第 31 行 ， 创 建 了 一 个 string 类 型 的 有 缓冲 的 通道 ， 缓 冲 的 容量 是 10。 在 
第 34 行 ,给 waitGroup 赋值 为 4， 代 表 创 建 了 4 个 工作 goroutine。 之 后 在 第 35 行 到 第 37 行 ， 
创建 了 4 个 goroutine， 并 传人 用 来 接收 工作 的 通道 。 在 第 40 行 到 第 42 行 ， 将 10 个 字符 串 发 送 
到 通道 , 模拟 发 给 goroutine 的 工作 。 一 旦 最 后 一 个 字符 串 发 送 到 通道 , 通道 就 会 在 第 46 行 关 闭 ， 
而 main 函数 就 会 在 第 49 行 等 待 所 有 工作 的 完成 。 

第 46 行 中 关闭 通道 的 代码 非常 重要 。 当 通道 关闭 后 ，goroutine 依旧 可 以 从 通道 接收 数据 ， 
但 是 不 能 再 向 通道 里 发 送 数据 。 能 够 从 已 经 关闭 的 通道 接收 数据 这 一 点 非常 重要 , 因为 这 人 允许 通 
道 关 闭 后 依旧 能 取出 其 中 缓冲 的 全 部 值 ， 而 不 会 有 数据 丢失 。 从 一 个 已 经 关闭 且 没 有 数据 的 通道 
里 获取 数据 ,总 会 立刻 返回 , 并 返回 一 个 通道 类 型 的 零 值 。 如 果 在 获取 通道 时 还 加 入 了 可 选 的 标 
志 ， 就 能 得 到 通道 的 状态 信息 。 

在 worker 函数 里 ， 可 以 在 第 58 行 看 到 一 个 无 限 的 for 循环 。 在 这 个 循环 里 , 会 处 理 所 有 
接收 到 的 工作 。 每 个 goroutine 都 会 在 第 60 行 阻塞 ， 等 待 从 通道 里 接收 新 的 工作 。 一 旦 接收 到 返 
回 ， 就 会 检查 ok 标志 ， 看 通道 是 否 已 经 清空 而 且 关 闭 。 如 果 ok 的 值 是 false ，goroutine 就 会 
终止 ， 并 调用 第 56 行 通过 defer 声明 的 Done 函数 ,通知 main 有 工作 结束 。 

如 果 ok 标志 是 true， 表 示 接 收 到 的 值 是 有 效 的 。 第 71 行 和 第 72 行 模拟 了 处 理 的 工作 。 
一 旦 工作 完成 ，goroutine 会 再 次 阻塞 在 第 60 行 从 通道 获取 数据 的 语句 。 一 旦 通道 被 关闭 ， 这 个 
从 通道 获取 数据 的 语句 会 立刻 返回 ，goroutine 也 会 终止 自己 。 

有 绥 冲 的 通道 和 无 缓冲 的 通道 的 例子 很 好 地 展示 了 如 何 编写 使 用 通道 的 代码 。 在 下 一 章 , 我 
们 会 介绍 真实 世界 里 的 一 些 可 能 会 在 工程 里 用 到 的 并 发 模式 。 















































































































































































































































































































































































































































X%X 小 结 








并 发 是 指 goroutine 运行 的 时 候 是 相互 独立 的 。 

使 用 关键 字 go 创建 goroutine 来 运行 水 数 。 

goroutine 在 逻辑 处 理 器 上 执行 ， 而 逻辑 处 理 器 具有 独立 的 系统 线程 和 运行 队列 。 
竞争 状态 是 指 两 个 或 者 多 个 goroutine 试图 访问 同一 个 资源 。 

原子 函数 和 互 斥 锁 提 供 了 一 种 防止 出 现 竞争 状态 的 办 法 。 

通道 提供 了 一 种 在 两 个 goroutine 之 间 共 享 数 据 的 简单 方法 。 

无 缓冲 的 通道 保证 同时 交换 数据 ， 而 有 缓冲 的 通道 不 做 这 种 保证 。 























第 7 蔓 并 发 模式 





本 章 主要 内 容 

加 ”控制 程序 的 生命 周期 

国 ”管理 可 复 用 的 资源 池 

加 ”创建 可 以 处 理 任 务 的 goroutine 池 


在 第 6 音 中 , 我 们 学 习 了 什么 是 并 发 ,通道 是 如 何 工作 的 ,并 学 习 了 可 以 实际 工作 的 并 发 代 
码 。 本 章 将 通过 学 习 更 多 代码 来 扩展 这 些 知识 。 我 们 会 学 习 3 个 可 以 在 实际 工程 里 使 用 的 包 , 这 
3 个 包 分 别 实现 了 不 同 的 并 发 模式 。 每 个 包 从 一 个 实用 的 视角 来 讲解 如 何 使 用 并 发 和 通道 。 我 们 
会 学 习 如 何 用 这 个 包 简化 并 发 程序 的 编写 ， 以 及 为 什么 能 简化 的 原因 。 


Xe» CH 


runner 包 用 于 展示 如 何 使 用 通道 来 监视 程序 的 执行 时 间 ， 如 果 程 序 运 行 时 间 太 长 ,也 可 以 
用 runner 包 来 终止 程序 。 当 开发 需要 调度 后 台 处 理 任 务 的 程序 的 时 候 , 这 种 模式 会 很 有 用 。 这 
个 程序 可 能 会 作为 cron 作业 执行 ， 或 者 在 基于 定时 任务 的 云 环境 (如 iron.io ) 里 执行 。 
让 我 们 来 看 一 下 runner 包 里 的 runnergo 代码 文件 ， 如 代码 清单 7-1 所 示 。 


代码 清单 7-1 runner/runner.go 
01 // Gabriel Aszalos 协助 完成 了 这 个 示例 
02 // runner 包 管 理 处 理 任务 的 运行 和 生命 周期 


03 Package runner 











04 

05 import ( 

06 "errors" 

07 VOS™ 

08 "os/signal" 
09 "time" 

10 ) 


12 
13 
14 
i5 





// Runner 在 给 定 的 超时 时 间 内 执行 一 组 任务 ， 
// 并 且 在 操作 系统 发 送 中 断 信 号 时 结束 这 些 任务 
type Runner struct { 

// interrupt 通道 报告 从 操作 系统 

// 发 送 的 信号 

interrupt chan os.Signal 









































// complete 通道 报告 处 理 任务 已 经 完成 
complete chan error 




















// timeout 报告 处 理 任务 已 经 超时 
timeout <-chan 七 ime .Time 











// tasks 持 有 一 组 以 索引 顺序 依次 执行 的 


















































// 函数 
tasks []func(int) 
} 
// ErrTimeout 会 在 任务 执行 超时 时 返 区 
Var ErrTimeout = errors.Newl("received timeout") 
// ErrIinterrupt 会 在 接收 到 操作 系统 的 事件 时 返 世 
var ErrIinterrupt = errors.New("received interrupt") 
// New 返回 一 个 新 的 准备 使 用 的 Runner 



































func New(d time.Duration) *Runner { 
return &Runnert{ 
interrupt: make (chan os.Signal, 1), 
complete: make (chan error), 
timeout: time.After (d), 


} 


// Aqd 将 一 个 任务 附加 到 Runner 上 。 这 个 任务 是 一 个 

// 接收 一 个 int 类 型 的 ID 作为 参数 的 函数 

func (r *Runner) Add (tasks ...func(int)) { 
r.tasks = append(r.tasks, tasks...) 








} 




















// Start 执行 所 有 任务 ， 并 监视 通道 事件 
func (r *Runner) Start() error { 
// 我 们 希望 接收 所 有 中 断 信号 


signal.Notifyl(r.interrupt, os.Interrupt) 

















// 用 不 同 的 goroutine 执行 不 同 的 任务 
go func() { 
r.complete <- r.run() 




















}() 

select { 

// 当 任务 处 理 完 成 时 发 出 的 信号 
Case err := <-r.complete: 


return err 








66 。。 // 当 任务 处 理 程序 运行 超时 时 发 出 的 信号 











67 case <-r.timeout: 

68 return ErrTimeout 
69 } 

了 人 

和 


72 // run 执行 每 一 个 已 注册 的 任务 


73 func (r *Runner) run() error { 















































74 for id, task := range r.tasks { 
75 // 检测 操作 系统 的 中 断 信号 

6 if r.gotIinterrupt () { 

77 return ErrIinterrupt 

78 } 

79 

80 // 执行 已 注册 的 任务 

81 task (id) 

82 } 

83 

84 return nil 

8 

86 

87 // gotInterrupt 验证 是 否 接收 到 了 中 断 信号 
88 func (r *Runner) gotInterrupt() bool { 
89 select 

90 // 当中 断 事件 被 触发 时 发 出 的 信和 号 

9F case <-r.interrupt: 

92 // 停止 接收 后 续 的 任何 信号 

93 signal.Stop(r.interrupt) 

95 return true 

96 

97 // 继续 正常 运行 

98 default: 

99 return false 
100 } 
101 } 





代码 清单 7-1 中 的 程序 展示 了 依据 调度 运行 的 无 人 值守 的 面向 任务 的 程序 , 及 其 所 使 用 的 并 
发 模式 。 在 设计 上 ， 可 支持 以 下 终止 点 : 

国 程序 可 以 在 分 配 的 时 间 内 完成 工作 ， 正 常 终止 ; 

国 程序 没有 及 时 完成 工作 ,“ 自 杀 ”; 

国 接收 到 操作 系统 发 送 的 中 断 事件 ， 程 序 立刻 试图 清理 状态 并 停止 工作 。 

让 我 们 走 查 一 遍 代码 ， 看 看 每 个 终止 点 是 如 何 实现 的 ， 如 代码 清单 7-2 所 示 。 











代码 清单 7-2 ”zunnez/runnergo: 第 12 行 到 第 28 行 
12 // Runner 在 给 定 的 超时 时 间 内 执行 一 组 任务 ， 











13 // 并 且 在 操作 系统 发 送 中 断 信 号 时 结束 这 些 任 务 
14 type Runner struct { 

5 // interrupt 通道 报告 从 操作 系统 
16 // 发 送 的 信号 


























17 interrupt chan os.Signal 























18 

19 // complete 通道 报告 处 理 任务 已 经 完成 
20 complete chan error 

业 业 

22 // timeout 报告 处 理 任务 已 经 超时 

3 timeout <-chan time.Time 

24 

25 // tasks 持 有 一 组 以 索引 顺序 依次 执行 的 
26 // 函数 

27 tasks []func(int) 

28 } 


代码 清单 7-2 从 第 14 行 声明 Runner 结构 开始 。 这 个 类 型 声明 了 3 个 通道 ， 用 来 辅助 管理 
程序 的 生命 周期 ， 以 及 用 来 表示 顺序 执行 的 不 同 任务 的 函数 切片 。 

第 17 行 的 interrupt 通道 收发 os .Signal 接口 类 型 的 值 ， 用 来 从 主机 操作 系统 接收 中 
断 事件 。os .Signal 接口 的 声明 如 代码 清单 7-3 所 示 。 


代码 清单 7-3 golang.org/pkg/0os/#5ignal 


// Signal 用 来 描述 操作 系统 发 送 的 信号 。 其 底层 实现 通常 会 
// 依赖 操作 系统 的 具体 实现 ， 在 UNIX 系统 上 是 
// syscall.Signal 
type Signal interface { 
String() string 
Signal () // 用 来 区 分 其 他 stringer 

































































} 

代码 清单 7-3 展示 了 os .Signal 接口 的 声明 。 这 个 接口 抽象 了 不 同 操作 系统 上 捕获 和 报告 
言 号 事件 的 具体 实现 。 

第 二 个 字段 被 命名 为 complete， 是 一 个 收发 error 接口 类 型 值 的 通道 ， 如 代码 清单 7-4 
所 示 。 


代码 清单 71-4 ”runner/runner.go: 第 19 行 到 第 20 行 


19 // complete 通道 报告 处 理 任务 已 经 完成 
20 complete chan error 


这 个 通道 被 命名 为 complete， 因 为 它 被 执行 任务 的 goroutine 用 来 发 送 任务 已 经 完成 的 信 
号 。 如 果 执 行 任务 时 发 生 了 错误 ， 会 通过 这 个 通道 发 回 一 个 error 接口 类 型 的 值 。 如 果 没 有 发 
生 错 误 ， 会 通过 这 个 通道 发 回 一 个 nil 值 作为 error 接口 值 。 

第 三 个 字段 被 命名 为 timeout ， 接 收 time .Time 值 ， 如 代码 清单 7-5 所 示 。 























代码 清单 1-5” runner/runner.go: 第 22 行 到 第 23 行 
22 // timeout 报告 处 理 任务 已 经 超时 


23 timeout <-chan 七 ime .Time 


这 个 通道 用 来 管理 执行 任务 的 时 间 。 如 果 从 这 个 通道 接收 到 一 个 time .Time 的 值 ， 这 个 程 








序 就 会 试图 清理 状态 并 停止 工作 。 
最 后 一 个 字段 被 命名 为 tasks ， 是 一 个 函数 值 的 切片 ， 如 代码 清单 7-6 所 示 。 


代码 清单 7-6 ”runner/runner.go: 第 25 行 到 第 27 行 


25 // tasks 持 有 一 组 以 索引 顺序 依次 执行 的 
26 // 函数 
2 tasks []func(int) 


这 些 函数 值 代表 一 个 接 一 个 顺序 执行 的 函数 。 会 有 一 个 与 main 函数 分 离 的 goroutine 来 执 





现在 已 经 声明 了 Runner 类 型 ， 接 下 来 看 一 下 两 个 error 接口 变量 ， 这 两 个 变量 分 别 代表 
不 同 的 错误 值 ， 如 代码 清单 7-7 所 示 。 


代码 清单 71-7 runner/runner.go: 第 30 行 到 第 34 行 


30 // ErrTimeout 会 在 任务 执行 超时 时 返回 


31 var ErrTimeout = errors.New("received timeout") 














33 // ErrIinterrupt 会 在 接收 到 操作 系统 的 事件 时 返回 

34 Var Errinterrupt = errors.New("received interrupt") 

第 一 个 error 接口 变量 名 为 ErrTimeout。 这 个 错误 值 会 在 收 到 超时 事件 时 ， 由 Start 
方法 返回 。 第 二 个 error 接口 变量 名 为 ErrIinterrupt。 这 个 错误 值 会 在 收 到 操作 系统 的 中 断 
事件 时 ， 由 Start 方法 返回 。 

现在 我 们 来 看 一 下 用 户 如 何 创 建 一 个 Ronner 类 型 的 值 ， 如 代码 清单 7-8 所 示 。 


代码 清单 7-8 zunnezr/runnergo: 第 36 行 到 第 43 行 


36 // New 返回 一 个 新 的 准备 使 用 的 Runner 


37 func New(d time.Duration) *Runne { 

















38 return &Runnert{ 

3.9 interrupt: make (chan os.Signal, 1), 
40 complete: make(chan error), 

41 timeout: time.After (d), 

42 } 

43 } 


代码 清单 7-8 展示 了 名 为 New 的 工厂 函数 。 这 个 函数 接收 一 个 time .Duration 类 型 的 值 ， 
并 返回 Runner 类 型 的 指针 。 这 个 函数 会 创建 一 个 Ruannet 类 型 的 值 ， 并 初始 化 每 个 通道 字段 。 
因为 task 字段 的 零 值 是 nil,， 已 经 满足 初始 化 的 要 求 , 所 以 没有 被 明确 初始 化 。 每 个 通道 字段 
都 有 独立 的 初始 化 过 程 ， 让 我 们 探究 一 下 每 个 字段 的 初始 化 细节 。 

通道 interrupt 被 初始 化 为 缓冲 区 容量 为 1 的 通道 。 这 可 以 保证 通道 至 少 能 接收 一 个 来 自 
语言 运行 时 的 os .Signal 值 ， 确 保 语 言 运行 时 发 送 这 个 事件 的 时 候 不 会 被 阻塞 。 如 果 goroutine 
没有 准备 好 接收 这 个 值 ， 这 个 值 就 会 被 丢弃 。 例 如 ， 如 果 用 户 反 复 融 CtrltC 组 合 键 ， 程 序 只 会 


在 这 个 通道 的 缓冲 区 可 用 的 时 候 接收 事件 ， 其 余 的 所 有 事件 都 会 被 丢弃 。 

通道 complete 被 初始 化 为 无 缓冲 的 通道 。 当 执行 任务 的 goroutine 完成 时 ， 会 向 这 个 通道 
发 送 一 个 erro 类 型 的 值 或 者 nil 值 。 之 后 就 会 等 待 main 函数 接收 这 个 值 。 一 旦 main 接收 
了 这 个 error 值 ，goroutine 就 可 以 安全 地 终止 了 。 

最 后 一 个 通道 timeout 是 用 time 包 的 After 图 数 初始 化 的 。Aftezr 因数 返回 一 个 
time .Time 类 型 的 通道 。 语 言 运行 时 会 在 指定 的 duration 时 间 到 期 之 后 , 向 这 个 通道 发 送 一 
个 time.Time 的 值 。 

现在 知道 了 如 何 创 建 并 初始 化 一 个 Runner 值 ， 我 们 再 来 看 一 下 与 Runner 类 型 关联 的 方 
法 。 第 一 个 方法 Aqq 用 来 增加 一 个 要 执行 的 任务 函数 ， 如 代码 清单 7-9 所 示 。 


代码 清单 7-9 ”runner/runner.go: 第 45 行 到 第 49 行 


45 // Add 将 一 个 任务 附加 到 Runner 上 。 这 个 任务 是 一 个 
46 // 接收 一 个 int 类 型 的 ID 作为 参数 的 函数 








47 func (r *Runner) Add(tasks ...func(int)) { 
48 r.tasks = append(r.tasks, tasks...) 
49 } 


代码 清单 7-9 展示 了 Ada 方法 ， 这 个 方法 接收 一 个 名 为 tasks 的 可 变 参数 。 可 变 参 数 可 以 
接受 任意 数量 的 值 作为 传人 参数 。 这 个 例子 里 , 这 些 传 人 的 值 必须 是 一 个 接收 一 个 整数 上 且 什么 都 
不 返回 的 函数 。 函 数 执行 时 的 参数 tasks 是 一 个 存储 所 有 这 些 传人 函数 值 的 切片 。 

现在 让 我 们 来 看 一 下 run 方法 ， 如 代码 清单 7-10 所 示 。 




















代码 清单 7-10 ”zunnezr/runnergo: 第 72 行 到 第 85 行 
72 // run 执行 每 一 个 已 注册 的 任务 


73 func (r *Runner) run() error { 


























74 for id, task := fange r.tasks { 
75 // 检测 操作 系统 的 中 断 信号 
6 if r.gotIinterrupt () { 
24 return ErrIinterrupt 
78 } 

79 

80 // 执行 已 注册 的 任务 

81 task (id) 

82 } 

83 

84 return nil 

85. 





代码 清单 7-10 的 第 73 行 的 run 方法 会 迭代 tasks 切片 ， 并 按 顺 序 执行 每 个 函数 。 函 数 会 
在 第 81 行 被 执行 。 在 执行 之 前 ,会 在 第 76 行 调用 got Interrupt 方法 来 检查 是 否 有 要 从 操作 
系统 接收 的 事件 。 

代码 清单 7-11 中 的 方法 got Interrupt 展示 了 带 default 分 支 的 select 语句 的 经 典 
用 法 。 





代码 清单 7-11 runner/runner.go: 第 87 行 到 第 101 行 


























87 // gotInterrupt 验证 是 否 接收 到 了 中 断 信号 
88 func (r *Runner) gotInterrupt() bool { 
89 select 

90 // 当中 断 事件 被 触发 时 发 出 的 信号 

91 case <-r.interrupt: 

92 // 停止 接收 后 续 的 任何 信号 

93 signal.Stop(r.interrupt) 

95 return true 

96 

97 // 继续 正常 运行 

98 default: 

99 return false 
100 } 
101 } 


在 第 91 行 ， 代 码 试图 从 interrupt 通道 去 接收 信和 号。 一 般 来 说 ，select 语句 在 没有 任 
何 要 接收 的 数据 时 会 阻塞 ， 不 过 有 了 第 98 行 的 default 分 文 就 不 会 阻塞 了 。default 分 文 会 
将 接收 interrupt 通道 的 阻塞 调用 转变 为 非 阻塞 的 。 如 果 ijnterrupt 通道 有 中 断 信号 需要 接 
收 ， 就 会 接收 并 处 理 这 个 中 断 。 如 果 没 有 需要 接收 的 信号 ， 就 会 执行 default 分 支 。 
当 收 到 中 断 信 号 后 ， 代 码 会 通过 在 第 93 行 调用 Stop 方法 来 停止 接收 之 后 的 所 有 事件 。 之 
后 函数 返回 true。 如 果 没 有 收 到 中 断 信 号 ， 在 第 99 行 该 方法 会 返回 false。 本 质 上 ， 
gotInterrupt 方法 会 让 goroutine 检查 中 断 信 号 ， 如 果 没 有 发 出 中 断 信 号 ， 就 继续 处 理工 作 。 
这 个 包 里 的 最 后 一 个 方法 名 为 Start ， 如 代码 清单 7-12 所 示 。 








代码 清单 7-12” runner/runner.go: 第 51 行 到 第 70 行 


















































51 // Start 执行 所 有 任务 ， 并 监视 通道 事件 

52 func (r *Runner) Start() error { 

53 // 我 们 希望 接收 所 有 中 断 信 号 

54 signal.Notifyl(r.interrupt, os.Interrupt) 
55 

56 // 用 不 同 的 goroutine 执行 不 同 的 任务 
57 go func() { 

58 r.complete <- r.run() 

59 }() 

60 

61 select { 

62 // 当 任务 处 理 完 成 时 发 出 的 信和 号 

63 case err := <-r.complete: 

64 return err 

65 

66 // 当 任 务 处 理 程序 运行 超时 时 发 出 的 信号 
67 case <-r.timeout: 

68 return ErrTimeout 

69 } 

OF 


方法 Start 实现 了 程序 的 主流 程 ,在 代码 清单 7-12 的 第 52 行 , Start 设置 了 gotInterrupt 





方法 要 从 操作 系统 接收 的 中 断 信号 。 在 第 56 行 到 第 59 行 ， 声 明了 一 个 匿名 函数 ， 并 单独 启动 
goroutine 来 执行 。 这 个 goroutine 会 执行 一 系列 被 赋予 的 任务 。 在 第 58 行 ， 在 goroutine 的 内 部 
调用 了 run 方法 ， 并 将 这 个 方法 返回 的 error 接口 值 发 送 到 complete 通道 。 一 旦 error 接 
口 的 值 被 接收 ， 该 goroutine 就 会 通过 通道 将 这 个 值 返回 给 调用 者 。 

创建 goroutine 后 ，Start 进入 一 个 select 语句 ， 阻 塞 等 待 两 个 事件 中 的 任意 一 个 。 如 果 
从 complete 通道 接收 到 error 接口 值 ,那么 该 goroutine 要 么 在 规定 的 时 间 内 完成 了 分 配 的 工 
作 ， 要么 收 到 了 操作 系统 的 中 断 信和 号。 无 论 哪 种 情况 ， 收 到 的 error 接口 值 都 会 被 返回 ， 随 后 
方法 终止 。 如 果 从 timeout 通道 接收 到 time .Time 值 ， 就 表示 goroutine 没有 在 规定 的 时 间 内 
完成 工作 。 这 种 情况 下 ， 程 序 会 返回 ErrTimeout 变量 。 

现在 看 过 了 runner 包 的 代码 , 并 了 解 了 代码 是 如 何 工 作 的 ， 让 我 们 看 一 下 main.go 代码 文 
件 中 的 测试 程序 ， 如 代码 清单 7-13 所 示 。 


代码 清单 7-13 runner/main/main.go 


01 // 这 个 示例 程序 演示 如 何 使 用 通道 来 监视 
02 // 程序 运行 的 时 间 ， 以 在 程序 运行 时 间 过 长 
03 // 时 如 何 终止 程序 


03 Package main 





























04 

05 import ( 

06 "Jog" 

07 "time"™ 

08 

09 "github.com/goinaction/code/chapter7/patterns/runner" 
LO) 


// timeout 规定 了 必须 在 多 少 秒 内 处 理 完成 


const timeout = 3 * time.Second 


func main () 


2 

3 

14 

15 // main 是 程序 的 入 口 
6 
log.Println("Starting work.") 
8 





19 // 为 本 次 执行 分 配 超时 时 间 





























20 r := runner.New (timeout) 

2 

22 // 加 入 要 执行 的 任务 

区 全 .Add (createTask (), createTask ()， createTask () ) 

24 

25 // 执行 任务 并 处 理 结果 

26 if err := r.Start(); err != nil { 

27 switch err { 

28 case runner.ErrTimeout: 

29 log.Println("Terminating due to timeout.") 
30 os .Exit (1) 

人 31 case runner.Errinterrupt: 

32 log.Println("Terminating due to interrupt.") 


33 OS Exit (2) 


35 } 

36 

37 log.Println("Process ended.") 
3.8: 让 

39 





40 // createTask 返回 一 个 根据 ia 
41 // 休 眼 指定 秒 数 的 示例 任务 


42 func createTask () func(int) { 





43 return func(id int) { 

44 log.Printf("Processor - Task #%d.", id) 

45 time.Sleep(time.Duration(id) * time.Secondgd) 
46 } 

47 } 


代码 清单 7-13 的 第 16 行 是 main 函数 。 在 第 20 行 ， 使 用 timeout 作为 超时 时 间 传 给 New 
函数 ,并 返回 了 一 个 指向 Runner 类 型 的 指针 。 之 后 在 第 23 行 , 使 用 createTask 函数 创建 了 
几 个 任务 , 并 被 加 入 Runner 里 。 在 第 42 行 声明 了 createTask 函数 。 这 个 函数 创建 的 任务 只 
是 休眠 了 一 段 时 间 ,用 来 模拟 正在 进行 工作 。 增 加 完 任 务 后 在 第 26 行 调用 了 Start 方法 ,main 
函数 会 等 待 Start 方法 的 返回 。 

当 Start 返回 时 ,会 检查 其 返回 的 error 接口 值 ， 并 存 人 err 变量 。 如 果 确 实 发 生 了 错 
误 ， 代 码 会 根据 err 变量 的 值 来 判断 方法 是 由 于 超时 终止 的 ， 还 是 由 于 收 到 了 中 断 信 号 终止 。 
如 果 没 有 错误 ,任务 就 是 按时 执行 完成 的 。 如 果 执 行 超时 ,程序 就 会 用 错误 码 1 终止 。 如 果 接 收 
到 中 断 信 和 号， 程序 就 会 用 错误 码 2 终止 。 其 他 情况 下 ， 程 序 会 使 用 错误 码 0 正常 终止。 
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本 章 会 介绍 pool 包 “。 这 个 包 用 于 展示 如 何 使 用 有 缓冲 的 通道 实现 资源 池 ， 来 管理 可 以 在 
任意 数量 的 goroutine 之 间 共 享 及 独立 使 用 的 资源 。 这 种 模式 在 需要 共享 一 组 静态 资源 的 情况 (如 
共享 数据 库 连 接 或 者 内 存 缓冲 区 ) 峡 E 常 有 用 。 如 果 goroutine 需 要 从 池 里 得 到 这 些 资 源 中 的 一 个 ， 
它 可 以 从 池 里 申请 ， 使 用 完 后 归还 到 资源 池 里 。 

让 我 们 看 一 下 pool 包 里 的 pool.go 代码 文件 ， 如 代码 清单 7-14 所 示 。 


代码 清单 7-14 Pool/pool.go 
01 // Fatih Arslan 和 Gabriel Aszalos 协助 完成 了 这 个 示例 
02 // 包 pool 管理 用 户 定义 的 一 组 资源 
03 package pool 


























04 

O05 impDort~( 

06 "errors" 
07 "LEGg” 














Q@ 本 书 是 以 Go 1.5 版 本 为 基础 写作 而 成 的 。 在 Go 1.6 及 之 后 的 版 本 中 ， 标 准 库 里 自 带 了 资源 池 的 实现 
( sync .Pool)。 推 荐 使 用 。 一 一 译 者 注 
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// Pool 管理 一 组 可 以 安全 地 在 多 个 goroutine 间 











VE 











k 享 的 资源 。 被 管理 


// 实现 io.Closer 接 
type Pool struct { 


} 














的 资源 必须 














m sync.Mutex 

resources chan io.Closer 

factory func() (io.Closer, error) 
closed bool 


// ErrPoolClosed 表示 请 求 (Acquire) 了 一 个 


Wy 站 经 


DSI 





关闭 的 池 


Var ErrPoolClosed 


// New 创建 一 个 用 来 管 




















= errors.New("Pool has been closedq.") 


理 资 源 的 池 。 


// 这 个 池 需 要 一 个 可 以 分 配 新 资源 的 函数 ， 


// 并 规定 池 的 大 小 











func New(ftn func() 


} 


if 


size <= 0 { 
return nil 





return &Poolf{ 


}7 


factory: 
resources: 
nil 


(io.Closer, 


error), size uint) 


(*Pool, 


, errors.New("Size Value too small.") 


£1 


make (chan io.Closer, size), 


// Acquire 从 池 中 获取 一 个 资源 


func 


} 


// Release 将 一 个 使 
(B. *Eo001) 


func 


(Pp *Pool) Acquire() 


select { 
// 检查 是 否 有 空闲 的 资源 


Case r, ok := 


// 


if lok { 
return 


} 


return rr, 


<-p.resources: 
log.Println("Acquire:", 


(io.Closer, error) { 


"Shared Resource") 


nil, ErrPoolClosed 


nil 








default: 
log.Println("Acquire:", 


A 


return p.f 


因为 没有 空闲 资源 可 

















actory () 














后 的 资源 放 











p.m.Lock () 





























池 里 














， 所 以 提供 一 个 新 资源 


"New Resource") 


Release(r io.Closer) { 


保证 本 操作 和 close 操作 的 安全 


error) 


62 defer p.m.Unlock () 





63 

64 // 如 果 池 已 经 被 关闭 ， 销 毁 这 个 资源 

65 if p.closed { 

66 r.Close() 

67 return 

68 } 

69 

70 select { 

ya // 试图 将 这 个 资源 放 入 队列 

中 儿 case 人 人 SOGOUTCGS 信和 证 

2 log.Println("Release:", "In Queue") 
74 

75 // 如 果 队 列 已 满 ， 则 关闭 这 个 资源 

76 default: 

77 log.Println("Release:", "Closing") 
78 r.Close() 

79 } 

80 1} 

81 








82 // Close 会 让 资源 池 停 止 工作 ， 并 关闭 所 有 现 有 的 资源 
83 func (p *Pool) Close() { 
84 // 保证 本 操作 与 Release 操作 的 安全 





















































85 p.m.Lock () 

86 defer p.m.Unlock () 

87 

88 // 如 果 pool 已 经 被 关闭 ， 什 么 也 不 做 
89 if p.closed { 

90 return 

91 } 

92 

93 // 将 池 关 闭 

94 p.closed = true 

95 

96 // 在 清空 通道 里 的 资源 之 前 ， 将 通道 关闭 
97 // 如 果 不 这 样 做 ， 会 发 生死 锁 

98 close(p.resources) 

99 
100 // 关闭 资源 
101 for r := range p.resources { 
102 r.Close() 
103 } 
104 } 


代码 清单 7-14 中 的 pool 包 的 代码 声明 了 一 个 名 为 Pool 的 结构 ,该 结构 允许 调用 者 根据 所 
需 数量 创建 不 同 的 资源 池 。 只 要 某 类 资源 实现 了 io.Closer 接口 ,就 可 以 用 这 个 资源 池 来 管理 。 
让 我 们 看 一 下 Pool 结构 的 声明 ， 如 代码 清单 7-15 所 示 。 





代码 清单 7-15 pool/pool.go: 第 12 行 到 第 20 行 
12 // Pool 管理 一 组 可 以 安全 地 在 多 个 goroutine 间 


























13 // 共享 的 资源 。 被 管理 的 资源 必须 

















14 // 实现 io.Closer 接 
15 type Pool struct { 





16 m sync.Mutex 

17 resources chan io.Closer 

18 factory func() (io.Closer, error) 
19 closed bool 

20 } 


Pool 结构 声明 了 4 个 字段 , 每 个 字段 都 用 来 辅助 以 goroutine 安全 的 方式 来 管理 资源 池 。 在 
第 16 行 ， 结 构 以 一 个 sync .Mutex 类 型 的 字段 开始 。 这 个 互 斥 锁 用 来 保证 在 多 个 goroutine 访 
问 资源 池 时 ， 池 内 的 值 是 安全 的 。 第 二 个 字段 名 为 resources， 被 声明 为 io .Closer 接口 类 
型 的 通道 。 这 个 通道 是 作为 一 个 有 缓冲 的 通道 创建 的 ,用 来 保存 共享 的 资源 。 由 于 通道 的 类 型 是 
一 个 接口 ， 所 以 池 可 以 管理 任意 实现 了 io.Closer 接口 的 资源 类 型 。 

factory 字段 是 一 个 函数 类 型 。 任 何 一 个 没有 输入 参数 且 返 回 一 个 io.closer 和 一 个 
error 接口 值 的 函数 ， 都 可 以 赋值 给 这 个 字段 。 这 个 函数 的 目的 是 ， 当 池 需 要 一 个 新 资源 时 ， 
可 以 用 这 个 函数 创建 。 这 个 函数 的 实现 细节 超出 了 pool 包 的 范围 , 并 且 需 要 由 包 的 使 用 者 实现 
并 提供 。 

第 19 行 中 的 最 后 一 个 字段 是 closed 字段 。 这 个 字段 是 一 个 标志 ， 表 示 Pool 是 否 已 经 被 
关闭 。 现 在 已 经 了 解 了 Pool 结构 的 声明 ,让 我 们 看 一 下 第 24 行 声明 的 error 接口 变量 ， 如 代 
码 清单 7-16 所 示 。 




















代码 清单 7-16 ”pool/pool.go: 第 22 行 到 第 24 行 





22 // ErrPoolClosed 表示 请 求 (Acquire) 了 一 个 

23 // 已 经 关闭 的 池 

24 Var ErrPoolClosed = errors.New("Pool has been closed.") 

Go 语言 里 会 经 常 创建 error 接口 变量 。 这 可 以 让 调用 者 来 判断 某 个 包 里 的 函数 或 者 方法 返 
回 的 具体 的 错误 值 。 当 调用 者 对 一 个 已 经 关闭 的 池 调 用 Acquire 方法 时 ,会 返回 代码 清单 7-16 
里 的 error 接口 变量 。 因 为 Acquire 方法 可 能 返回 多 个 不 同类 型 的 错误 , 所 以 Poo1 已 经 关闭 
时 会 关闭 时 返回 这 个 错误 变量 可 以 让 调用 者 从 其 他 错误 中 识别 出 这 个 特定 的 错误 。 

既然 已 经 声明 了 Pool 类 型 和 error 接口 值 ， 我 们 就 可 以 开始 看 一 下 Pool 包 里 声明 的 函 
数 和 方法 了 。 让 我 们 从 池 的 工厂 函数 开始 ， 这 个 函数 名 为 New， 如 代码 清单 7-17 所 示 。 











代码 清单 7-17 pool/pool.go: 第 26 行 到 第 38 行 




















26 // New 创建 一 个 用 来 管理 资源 的 池 。 
27 // 这 个 池 需 要 一 个 可 以 分 配 新 资源 的 函数 ， 
28 // 并 规定 池 的 大 小 




















29 func New(fn func() (io.Closer, error), size uint) (*Pool, error) { 
30 if size <= 0 { 

1 return nil, errors.New("Size Value too small.") 

32 } 

33 


34 return &Poolf{ 


33 factory: fny 


36 resources: make (chan io.Closer, size), 
37 FP 
38 5 





代码 清单 7-17 中 的 New 函数 接受 两 个 参数 ， 并 返回 两 个 值 。 第 一 个 参数 fn 声明 为 一 个 函 
数 类 型 ， 这 个 函数 不 接受 任何 参数 ， 返 回 一 个 io .closer 和 一 个 error 接口 值 。 这 个 作为 参 
数 的 函数 是 一 个 工厂 函数 ， 用 来 创建 由 池 管 理 的 资源 的 值 。 第 二 个 参数 size 表示 为 了 保存 资源 
而 创建 的 有 缓冲 的 通道 的 缓冲 区 大 小 。 

第 30 行 检查 了 size 的 值 ， 保 证 这 个 值 不 小 于 等 于 0。 如 果 这 个 值 小 于 等 于 0， 就 会 使 用 
nil 值 作为 返回 的 pool 指针 值 ， 然 后 为 该 错误 创建 一 个 error 接口 值 。 因 为 这 是 这 个 函数 唯 
一 可 能 返回 的 错误 值 ， 所 以 不 需要 为 这 个 错误 单独 创建 和 使 用 一 个 error 接口 变量 。 如 果 能 够 
接受 传人 的 size ， 就 会 创建 并 初始 化 一 个 新 的 Pool 值 。 在 第 35 行 ， 函 数 参 数 fn 被 赋值 给 
factory 字段 ,并 且 在 第 36 行 , 使 用 size 值 创建 有 缓冲 的 通道 在 return 语句 里 ， 可 以 构 
造 并 初始 化 任何 值 。 因 此 ， 第 34 行 的 return 语句 用 指向 新 创建 的 Pool 类 型 值 的 指针 和 nil 
值 作为 error 接口 值 ， 返回 给 函数 的 调用 者 。 

在 创建 并 初始 化 Pool 类 型 的 值 之 后 ， 接 下 来 让 我 们 来 看 一 下 Acquire 方法 ， 如 代码 清单 
7-18 所 示 。 这 个 方法 可 以 让 调用 者 从 池 里 获得 资源 。 












































代码 清单 7-18 ”Pool/pool.go: 第 40 行 到 第 56 行 
40 // Acquire 从 池 中 获取 一 个 资源 






































41 func (p *Pool) Acquire() (io.Closer, error) { 
42 select 1{ 

43 // 检查 是 否 有 空闲 的 资源 

44 Case r, ok := <-p.resources: 

45 log.Println("Acquire:", "Shared Resource") 
46 if lok { 

47 return nil, ErrPoolClosed 

48 } 

49 return r, nil 

50 

51 // 因为 没有 空闲 资源 可 用 ， 所 以 提供 一 个 新 资源 

52 default: 

53 log.Println("Acquire:", "New Resource") 
54 return p.factory () 

SR } 

96" 


代码 清单 7-18 包含 了 Acquire 方法 的 代码 。 这 个 方法 在 还 有 可 用 资源 时 会 从 资源 池 里 返回 
一 个 资源 , 否则 会 为 该 调用 创建 并 返回 一 个 新 的 资源 。 这 个 实现 是 通过 select/case 语句 来 检 
查 有 缓冲 的 通道 里 是 否 还 有 资源 来 完成 的 。 如 果 通 道里 还 有 资源 ， 如 第 44 行 到 第 49 行 所 写 , 就 
取出 这 个 资源 ， 并 返回 给 调用 者 。 如 果 该 通道 里 没有 资源 可 取 ， 就 会 执行 default 分 文 。 在 这 
个 示例 中 ， 在 第 54 行 执行 用 户 提 供 的 工厂 函数 ， 并 且 创 建 并 返回 一 个 新 资源 。 

如 果 不 再 需要 已 经 获得 的 资源 ， 必 须 将 这 个 资源 释放 回 资源 池 里 。 这 是 Release 方法 的 任 























务 。 不 过 在 理解 Release 方法 的 代码 背后 的 机 制 之 前 ， 我 们 需要 先 看 一 下 Close 方法 ， 如 代 
人 码 清单 7-19 所 示 。 


代码 清单 7-19 pool/pool.go: 第 82 行 到 第 104 行 








82 // close 会 让 资源 池 停 止 工作 ， 并 关闭 所 有 现 有 的 资源 
83 func (p *Pool) Close() { 
84 // 保证 本 操作 与 Release 操作 的 安全 





















































85 p.m.Lock() 
86 defer p.m.Unlock () 
87 
88 // 如 果 pool 已 经 被 关闭 ， 什 么 也 不 做 
89 if p.closed { 
90 return 
91 } 
92 
93 // 将 池 关 闭 
94 p.closed = true 
95 
96 // 在 清空 通道 里 的 资源 之 前 ， 将 通道 关闭 
97 // 如 果 不 这 样 做 ， 会 发 生死 锁 
98 close(p.resources) 
99 
100 // 关闭 资源 
101 for r := range p.resources { 
102 r.Close() 
103 } 
104 } 


一 旦 程序 不 再 使 用 资源 池 ， 需 要 调用 这 个 资源 池 的 Close 方法 。 代 码 清单 7-19 中 展示 了 
Close 方法 的 代码 。 在 第 98 行 到 第 101 行 ， 这 个 方法 关闭 并 清空 了 有 缓冲 的 通道 ， 并 将 缓冲 的 
空闲 资源 关闭 。 需 要 注意 的 是 ， 在 同一 时 刻 只 能 有 一 个 goroutine 执行 这 段 代 码 。 事 实 上 ， 当 这 
段 代码 被 执行 时 ,必须 保证 其 他 goroutine 中 没有 同时 执行 Release 方法 。 你 一 会 儿 就 会 理解 为 
什么 这 很 重要 。 

在 第 85 行 到 第 86 行 ， 互 斥 量 被 加 锁 ， 并 在 函数 返回 时 解锁 。 在 第 89 行 ， 检 查 closed 标 
志 ,， 判 断 池 是 不 是 已 经 关闭 。 如 果 已 经 关闭 ， 该 方法 会 直接 返回 ， 并 释放 锁 。 如 果 这 个 方法 第 一 
次 被 调用 ， 就 会 将 这 个 标志 设置 为 true， 并 关闭 日 清空 resources 通道 。 

现在 我 们 可 以 看 一 下 Release 方法 ， 看 看 这 个 方法 是 如 何 和 Close 方法 配合 的 ， 如 代码 
清单 7-20 所 示 。 

















代码 清单 7-20 ”pool/pool.go: 第 58 行 到 第 80 行 














58 // Release 将 一 个 使 用 后 的 资源 放 回 池 里 
59 func (p *Pool) Releasel(r io.Closer) { 
60 // 保证 本 操作 和 close 操作 的 安全 

61 p.m.Lock () 

62 defer p.m.Unlock () 











64 // 如 果 池 已 经 被 关闭 ， 销 毁 这 个 资源 








65 if p.closed { 

66 r.Close() 

67 return 

68 } 

69 

70 select { 

71 // 试图 将 这 个 资源 放 入 队列 

72 Sase Presources = 1 

学 车 log.Println("Release:", "In Queue") 
74 

75 // 如 果 队 列 已 满 ， 则 关闭 这 个 资源 

76 default: 

7 log.Println("Release:", "Closing") 
78 r.Close() 

79 } 

80 } 


在 代码 清单 7-20 中 可 以 找到 Release 方法 的 实现 ,该 方法 一 开始 在 第 61 行 和 第 62 行 对 互 
斥 量 进行 加 锁 和 解锁 。 这 和 Close 方法 中 的 互 斥 量 是 同一 个 互 斥 量 。 这 样 可 以 阻止 这 两 个 方法 
在 不 同 goroutine 里 同时 和 运行。 使 用 互 斥 量 有 两 个 目的 。 第 一 ， 可 以 保护 第 65 行 中 读 取 closed 
标志 的 行为 ， 保 证 同一 时 刻 不 会 有 其 他 goroutine 调用 Close 方法 写 同 一 个 标志 。 第 二 ， 我 们 不 























想 往 一 个 已 经 关闭 的 通道 里 发 送 数据 ， 因 为 那样 会 引起 骨 溃 。 如 果 closed 标志 是 true，, 我 们 


就 知道 resources 通道 已 经 被 关闭 。 
在 第 66 行 ,如果 池 已 经 被 关闭 , 会 直接 调用 资源 值 r 的 Close 方法 。 因 为 这 

















时 已 经 清空 


关闭 了 池 , 所 以 无 法 将 资源 重新 放 回 到 该 资源 池 里 。 对 closed 标志 的 读 写 必须 进行 同步 , 否则 
可 能 误导 其 他 goroutine， 让 其 认为 该 资源 池 依旧 是 打开 的 ， 并 试图 对 通道 进行 无 效 的 操作 。 
现在 看 过 了 池 的 代码 ， 了 解 了 池 是 如 何 工作 的 ， 让 我 们 看 一 下 main.go 代码 文件 里 的 测试 程 


序 ， 如 代码 清单 7-21 所 示 。 


代码 清单 7-21 pool/main/main.go 


01 // 这 个 示例 程序 展示 如 何 使 用 pool 包 
02 // 来 共享 一 组 模拟 的 数据 库 连 接 


03 package main 














04 

05 import (人 

06 ele 抽 | 

07 TD 

08 "math/rand" 
09 Vsyne" 

10 "sync/atomic" 
11 "time" 

于 分 

13 "github.com/goinaction/code/chapter7/patterns/pool" 
14 ) 

15 


16 const ( 


21 


68 











maxGoroutines = 25 // 使 用 的 goroutine 的 数量 
pooledResources = 2 // 池 中 的 资源 的 数量 





) 




















// dbConnection 模拟 要 共享 的 资源 
type dbConnection struct { 
ID int32 





} 














// Close 实现 了 io.Closer 接口 ， 以 便 dbconnection 

// 可 以 被 池 管 理 。close 用 来 完成 任意 资源 的 

// 释放 管理 

func (dbConn *dbConnection) Close() error { 
log.Println("Close: Connection", dbConn.ID) 
return nil 





















































// idcounter 用 来 给 每 个 连接 分 配 一 个 独一无二 的 ia 
var idCounter int32 











// createConnection 是 一 个 工厂 函数 ， 

// 当 需 要 一 个 新 连接 时 ， 资 源 池 会 调用 这 个 函数 

func createConnection() (io.Closer, error) { 
id := atomic.AddIint32(&idCounter, 1) 
log.Println("Create: New Connection", id) 





























return &dbConnection{id}, nil 
} 














// main 是 所 有 Go 程序 的 入 
func main() { 
var wg sync.WaitGroup 
wg.Add (maxGoroutines) 





























// 创建 用 来 管理 连接 的 池 
p, err := Pool.New(createCconnection pooledResources) 
if err != nil { 


log.Println (err) 
} 




















// 使 用 池 里 的 连接 来 完成 查询 
for query := 0; dquery < maxGoroutines; query++ { 
// 每 个 goroutine 需要 自己 复制 一 份 要 
// 查询 值 的 副本 ,不然 所 有 的 查询 会 共享 
// 同一 个 查询 变量 
go func(q int) { 
performQueries (gq, p) 
wg .Done () 
} (query) 

















} 


// 等 待 goroutine 结束 
wg .Wait () 


71 // 关闭 池 


22 log.Println("Shutdown Program.") 
13 P.Close() 

74 } 

5 


76 // performQueries 用 来 测试 连接 的 资源 池 
77 func performQueries (query int, p xpool.Pool) { 


78 // 从 池 里 请 求 一 个 连接 























79 conn, err := p.Acquire() 

80 if err != nil { 

81 log.Println (err) 

82 return 

83 } 

84 

85 // 将 该 连接 释放 回 池 里 

86 defer p.Release (conn) 

87 

88 // 用 等 待 来 模拟 查询 响应 

89 time.Sleep(time.Duration(rand.Intn(1000)) * time.Millisecondgd) 
90 log.Printf ("QID[%d] CID[%d]\n", query, conn. (*dbConnection) .ID) 
91 3 


代码 清单 7-21 展示 的 main.go 中 的 代码 使 用 Pool 包 来 管理 一 组 模拟 数据 库 连 接 的 连接 
池 。 代 码 一 开始 声明 了 两 个 常量 maxGoroutines 和 pooledResource， 用 来 设置 goroutine 
的 数量 以 及 程序 将 要 使 用 资源 的 数量 , 资源 的 声明 以 及 io .Closer 接口 的 实现 如 代码 清单 7-22 
所 示 。 


代码 清单 7-22 ” pool/main/main.go: 第 21 行 到 第 32 行 


21 // dbConnection 模拟 要 共享 的 资源 
22 type dbConnection struct { 





23 ID int32 
24 } 














26 // Close 实现 了 io.Closer 接口 ， 以 便 abconnection 
27 // 可 以 被 池 管 理 。close 用 来 完成 任意 资源 的 
28 // 释放 管理 


29 func (dbConn *dbConnection) Close() error { 














30 log.Println("Close: Connection", dbConn.ID) 
人 3. return nil 
32 } 


代码 清单 7-22 展示 了 dbConnection 结构 的 声明 以 及 io.Closer 接口 的 实现 。 
dbConnection 类 型 模拟 了 管理 数据 库 连 接 的 结构 ， 当 前 版 本 只 包含 一 个 字段 TD， 用 来 保存 每 
个 连接 的 唯一 标识 。Close 方法 只 是 报告 了 连接 正在 被 关闭 ， 并 显示 出 要 关闭 连接 的 标识 。 

接 下 来 我 们 来 看 一 下 创建 sbconnection 值 的 工厂 函数 ， 如 代码 清单 7-23 所 示 。 





代码 清单 7-23 ”pool/main/main.go: 第 34 行 到 第 44 行 


34 // idcounter 用 来 给 每 个 连接 分 配 一 个 独一无二 的 ia 








35 var idCounter int32 


37 // createConnection 是 一 个 工厂 函数 ， 




















38 // 当 需 要 一 个 新 连接 时 ， 资 源 池 会 调用 这 个 函数 

39 func createConnection() (io.Closer, error) { 
40 id := atomic.AddIint32(&idCounter, 1) 

41 log.Println("Create: New Connection", id) 
42 

43 return &dbConnection{id}, nil 

44 } 


代码 清单 7-23 展示 了 createConnection 冰 数 的 实现 。 这 个 函数 给 连接 生成 了 一 个 唯一 
标识 ， 显 示 连 接 正 在 被 创建 ， 并 返回 指向 带 有 唯一 标识 的 dbCconnection 类 型 值 的 指针 。 唯 一 
标识 是 通过 atomic.AddqInt32 也 数 生 成 的 。 这 个 函数 可 以 安全 地 增加 包 级 变量 ijdCounter 
的 值 。 现 在 有 了 资源 以 及 工厂 函数 ， 我 们 可 以 配合 使 用 pool 包 了 。 

接 下 来 让 我 们 看 一 下 main 函数 的 代码 ， 如 代码 清单 7-24 所 示 。 


代码 清单 7-24 pool/main/main.go: 第 48 行 到 第 55 行 
































48 Var wg sync.WaitGroup 

49 wg.Add (maxGoroutines) 

50 

51 // 创建 用 来 管理 连接 的 池 

52 p, err := pool.New(createConnection, pooledResources) 
53 if err != nil { 

54 log.Println (err) 

58 } 


在 第 48 行 , main 函数 一 开始 就 声明 了 一 个 WaitGroup 值 , 并 将 WaitGroup 的 值 设 置 为 
要 创建 的 goroutine 的 数量 。 之 后 使 用 pool 包 里 的 New 函数 创建 了 一 个 新 的 Pool 类 型 。 工 厂 
函数 和 要 管理 的 资源 的 数量 会 传人 New 函数 。 这 个 函数 会 返回 一 个 指向 Pool 值 的 指针 ， 并 检 
查 可 能 的 错误 。 现 在 我 们 有 了 一 个 Pool 类 型 的 资源 池 实 例 ， 就 可 以 创建 goroutine， 并 使 用 这 个 
资源 池 在 goroutine 之 间 共 享 资 源 ， 如 代码 清单 7-25 所 示 。 








代码 清单 7-25 Pool/main/main.go: 第 57 行 到 第 66 行 





























57 // 使 用 池 里 的 连接 来 完成 查询 

58 for query := 0; dquery < maxGoroutines; query++ { 
59 // 每 个 goroutine 需要 自己 复制 一 份 要 

60 // 查询 值 的 副本 ,不然 所 有 的 查询 会 共享 

61 // 同一 个 查询 变量 

62 go func(G int) { 

63 performQueries (gq, p) 

64 wg .Done () 

65 } (query) 

66 } 


代码 清单 7-25 中 用 一 个 for 循环 创建 要 使 用 池 的 goroutine 。 每 个 goroutine 调用 一 次 
performQueries 函数 然后 退出 。performouetries 限 数 需要 传人 一 个 唯一 的 ID 值 用 于 做 日 


志 以 及 一 个 指向 Pool 的 指针 ,一 旦 所 有 的 goroutine 都 创建 完成 ,main 函数 就 等 待 所 有 goroutine 
执行 完毕 ， 如 代码 清单 7-26 所 示 。 


代码 清单 7-26 ”pool/main/main.go: 第 68 行 到 第 73 行 








68 // 等 待 goroutine 结束 

69 wg .Wait () 

70 

5 // 关闭 池 

2 log.Println("Shutdown Program.") 
3 p.Close() 


在 代码 清单 7-26 中 ,main 函数 等 待 WaitGroup 实例 的 Wait 方法 执行 完成 一旦 所 有 goroutine 
都 报告 其 执行 完成 , 就 关闭 Pool, 并 且 终 止 程序 。 接 下 来 , 让 我 们 看 一 下 performQueries 函数 。 
这 个 函数 使 用 了 池 的 Acquire 方法 和 Release 方法 ， 如 代码 清单 7-27 所 示 。 





代码 清单 7-27 pool/main/main.go: 第 76 行 到 第 91 行 


76 // performQueries 用 来 测试 连接 的 资源 池 
77 func performQueries (query int, p xpool.Pool) { 


78 // 从 池 里 请 求 一 个 连接 









































79 conn, err := p.Acquire() 

80 if err != nil { 

81 log.Println (err) 

82 return 

83 } 

84 

85 // 将 该 连接 释放 回 池 里 

86 defer p.Release (conn) 

87 

88 // 用 等 待 来 模拟 查询 响应 

89 time.Sleep(time.Duration(rand.Intn(1000)) * time.Millisecond) 
90 log.Printf ("QID[%d] CIDI[%d]\n", query, conn. (*dbConnection) .ID) 
91 } 


代码 清单 7-27 展示 了 performQueries 的 实现 。 这 个 实现 使 用 了 pool 的 Acquire 方法 
和 Release 方法 。 这 个 函数 首先 调用 了 Acdauire 方法 ， 从 池 里 获得 dbConnection。 之 后 会 
检查 返回 的 error 接口 值 ， 在 第 86 行 ， 再 使 用 defer 语句 在 函数 退出 时 将 dpConnection 
释放 回 池 里 。 在 第 89 行 和 第 90 行 ， 随 机 休眠 一 段 时 间 ， 以 此 来 模拟 使 用 abconnection 工作 
时 间 。 





XX PR 


work 包 的 日 的 是 展示 如 何 使 用 无 缓冲 的 通道 来 创建 一 个 goroutine 池 ， 这 些 goroutine 执行 
并 控制 一 组 工作 ,让 其 并 发 执行 。 在 这 种 情况 下 ,使 用 无 缓冲 的 通道 要 比 随意 指 定 一 个 缓冲 区 大 
小 的 有 缓冲 的 通道 好 ， 因 为 这 个 情况 下 既 不 需要 一 个 工作 队列 ， 也 不 需要 一 组 goroutine 配合 执 
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行 。 无 缓冲 的 通道 保证 两 个 goroutine 之 间 的 数据 交换 。 这 种 使 用 无 缓冲 的 通道 的 方法 允许 使 用 
者 知道 什么 时 候 goroutine 池 正 在 执行 工作 ， 而 且 如 果 池 里 的 所 有 goroutine 都 忙 ， 无 法 接受 新 的 
工作 的 时 候 , 也 能 及 时 通过 通道 来 通知 调用 者 。 使 用 无 缓冲 的 通道 不 会 有 工作 在 队列 里 丢失 或 者 
卡 住 ， 所 有 工作 都 会 被 处 理 。 

让 我 们 来 看 一 下 work 包 里 的 work.go 代码 文件 ， 如 代码 清单 7-28 所 示 。 


代码 清单 7-28 work/work.go 


01 // Jason Waldrip 协助 完成 了 这 个 示例 
02 // work 包 管 理 一 个 goroutine 池 来 完成 工作 
03 package work 

04 

05 import "sync" 

06 

07 // Worker 必须 满足 接口 类 型 ， 

08 // 才能 使 用 工作 池 

09 type Worker interface { 

0 Task() 

下 















































2 

3 // Pool 提供 一 个 goroutine 池 ， 这 个 池 可 以 完成 
4 // 任何 已 提交 的 Worker 任务 

5 type Pool struct { 
6 
7 
8 




















work chan Worker 
wg sync.WaitGroup 
} 





20 // New 创建 一 个 新 工作 池 

21 func New (maxGoroutines int) *Pool { 
22 p := Poolf{ 

23 work: make (chan Worker), 

24 } 





26 p.wg.Add (maxGoroutines) 

27 for i := 0; i < maxGoroutines; i++ { 
28 go func() { 

29 for Ww := range p.work { 

30 w.Task() 

引 了 } 

名 2 D.wg.Done () 

33 }(0) 

34 } 


36 return &p 
37 十 


39 // Run 提交 工作 到 工作 池 

40 func (p *Pool) Run(w Worker) { 
41 Pp.work <- w 

42 } 
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44 // Shutdown 等 待 所 有 goroutine 停止 工作 
45 func (p *Pool) Shutdown() { 


46 close (p.work) 
47 p.wg.Wait () 
48 } 


代码 清单 7-28 中 展示 的 work 包 一 开始 声明 了 名 为 Worker 的 接口 和 名 为 Pool 的 结构 ， 
如 代码 清单 7-29 所 示 。 





代码 清单 7-29 ”work/work.go: 第 07 行 到 第 18 行 














07 // Worker 必须 满足 接口 类 型 ， 
08 // 才能 使 用 工作 池 

09 type Worker interface { 
0 Task() 

下 冰 





























3 // Pool 提供 一 个 goroutine 池 ， 这 个 池 可 以 完成 
4 // 任何 已 提交 的 Worker 任务 
5 type Pool struct { 

















6 work chan Worker 
7 wg sync.WaitGroup 
8 } 


代码 清单 7-29 的 第 09 行 中 的 Worker 接口 声明 了 一 个 名 为 Task 的 方法 。 在 第 15 行 , 声 
明了 名 为 Pool 的 结构 ， 这 个 结构 类 型 实现 了 goroutine 池 ， 并 实现 了 一 些 处 理工 作 的 方法 。 这 
个 结构 类 型 声明 了 两 个 字段 ， 一 个 名 为 work (一 个 Worker 接口 类 型 的 通道 )， 另 一 个 名 为 wg 
的 sync.WaitGroup 类 型 。 


接 下 来 ， 让 我 们 来 看 一 下 work 包 的 工厂 函数 ， 如 代码 清单 7-30 所 示 。 





代码 清单 7-30 ”work/work.go: 第 20 行 到 第 37 行 


20 // New 创建 一 个 新 工作 池 

21 func New (maxGoroutines int) *Pool { 
2 p := Pool{ 

六 过 work: make (chan Worker), 

24 } 

25 

26 p.wg.Add (maxGoroutines) 

27 for i := 0; i < maxGoroutines; i++ { 
28 go func() { 

29 for Ww := range p.work { 
| wW.Task() 

31 } 

32 p.wg.Done() 

33 }-() 

34 } 

35 

36 return &p 

3 让 





代码 清单 7-30 展示 了 New 函数 ， 这 个 函数 使 用 固定 数量 的 goroutine 来 创建 一 个 工作 池 。 
goroutine 的 数量 作为 参数 传 给 New 函数 。 在 第 22 行 , 创建 了 一 个 Pool 类 型 的 值 ， 并 使 用 无 绥 
冲 的 通道 来 初始 化 work 字段 。 

之 后 ,在 第 26 行 ， 初 始 化 WaitGroup 需要 等 待 的 数量 ， 并 在 第 27 行 到 第 34 行 ， 创 建 了 
同样 数量 的 goroutine。 这 些 goroutine 只 接收 Worker 类 型 的 接口 值 ， 并 调用 这 个 值 的 Task 方 
法 ， 如 代码 清单 7-31 所 示 。 














代码 清单 7-31 work/work.go: 第 28 行 到 第 33 行 


28 go func() { 

29 for wW := range p.work { 
30 w.Task () 

34 } 

32 P.wg.Done () 

33 }() 


代码 清单 7-31 里 的 for range 循环 会 一 直 阻 塞 ， 直 到 从 work 通道 收 到 一 个 Worker 接 
口 值 。 如 果 收 到 一 个 值 ， 就 会 执行 这 个 值 的 Task 方法 。 一 旦 work 通道 被 关闭 ，for range 
循环 就 会 结束 ， 并 调用 WaitGroup 的 Done 方法 。 然 后 goroutine 终止。 

现在 我 们 可 以 创建 一 个 等 竺 并 执行 工作 的 goroutine 池 了 。 让 我 们 看 一 下 如 何 向 池 里 提交 工 
作 ， 如 代码 清单 7-32 所 示 。 








代码 清单 7-32 ”work/work.go: 第 39 行 到 第 42 行 
39 // Run 提交 工作 到 工作 池 














40 func (p *Pool) Run(w Worker) { 
41 Pp.work < 一 w 
42 } 


代码 清单 7-32 展示 了 Run 方法 。 这 个 方法 可 以 向 池 里 提交 工作 。 该 方法 接受 一 个 Worker 
类 型 的 接口 值 作为 参数 , 并 将 这 个 值 通过 work 通道 发 送 。 由 于 work 通道 是 一 个 无 缓冲 的 通道 ， 
调用 者 必须 等 待 工作 池 里 的 某 个 goroutine 接收 到 这 个 值 才 会 返回 。 这 正 是 我 们 想 要 的 ， 这 样 可 
以 保证 调用 的 Run 返回 时 ， 提 交 的 工作 已 经 开始 执行 。 

在 某 个 时 间 点 ,需要 关闭 工作 池 。 这 是 Shut down 方法 所 做 的 事情 ,如 代码 清单 7-33 所 示 。 


代码 清单 7-33 ”work/work.go: 第 44 行 到 第 48 行 


44 // Shutdown 等 待 所 有 goroutine 停止 工作 
45 func (p *Pool) Shutdown() { 





46 close (p.work) 
47 p.wg.Wait () 
48 } 


代码 清单 7-33 中 的 Shut down 方法 做 了 两 件 事 ， 首 先 ， 它 关闭 了 work 通道 ， 这 会 导致 所 
有 池 里 的 goroutine 停止 工作 ， 并 调用 WaitGroup 的 Done 方法 ; 然后 ，Shutqown 方法 调用 
WaitGroup 的 Wait 方法 ， 这 会 让 Shutdown 方法 等 待 所 有 goroutine 终止 。 


我 们 看 了 work 包 的 代码 ， 并 了 解 了 它 是 如 何 工作 的 ， 接 下 来 让 我 们 看 一 下 main.go 源 代码 
文件 中 的 测试 程序 ， 如 代码 清单 7-34 所 示 。 


代码 清单 7-34 work/main/main.go 





01 // 这 个 示例 程序 展示 如 何 使 用 work 包 
02 // 创建 一 个 goroutine 池 并 完成 工作 


03 Package main 





























04 
05 import ( 
06 ole Mi 
07 SVG 
08 "time" 
09 
10 "github.com/goinaction/code/chapter7/patterns/work" 
11 ) 
2 
13 // names 提供 了 一 组 用 来 显示 的 名 字 
4 var names = []stringt{ 
5 "steve", 
6 "beob", 
7 "mary", 
8 "therese", 
19 "jasonY, 
20 } 


22 // namePrinter 使 用 特定 方式 打印 名 字 


23 type namePrinter struct { 





























24 name string 

2 

26 

27 // Task 实现 Worker 接口 

28 func (m *namePrinter) Task() { 

29 log.Println (m.name) 

30 time.Sleep (time.Second) 

3 让 

32 

33 // main 是 所 有 Go 程序 的 入 口 

34 func main() { 

35 // 使 用 两 个 goroutine 来 创建 工作 池 
36 P := work.New (2) 

37 

38 Var wg sync.WaitGroup 

39 wg.Add(100 * len (names)) 

40 

41 for i := 0; i < 100; i++ { 

42 // 迭代 names 切片 

43 for , name := range names { 
44 // 创建 一 个 namePrinter 并 提供 
45 // 指定 的 名 字 

46 np := namePrintert{ 

47 name: name, 


48 小 


50 go func() { 

51 // 将 任务 提交 执行 。 当 Run 返回 时 
52 // 我 们 就 知道 任务 已 经 处 理 完成 
53 p.Run (&np) 

54 wg .Done () 

55 }() 











59 wg .Wait () 


61 // 让 工作 池 停 止 工作 ， 等 待 所 有 现 有 的 
62 // 工作 完成 
63 P.Shutadown () 











代码 清单 7-34 展示 了 使 用 work 包 来 完成 名 字 显 示 工 作 的 测试 程序 。 这 段 代 码 一 开始 在 第 
14 行 声明 了 名 为 names 的 包 级 的 变量 ， 这 个 变量 被 声明 为 一 个 字符 串 切 片 。 这 个 切片 使 用 5 个 
名 字 进 行 了 初始 化 。 然 后 声明 了 名 为 namePrinter 的 类 型 ， 如 代码 清单 7-35 所 示 。 





代码 清单 7-35 ”work/main/main.go: 第 22 行 到 第 31 行 


22 // namePrinter 使 用 特定 方式 打印 名 字 
23 type namepPrinter struct { 

















24 name string 

.5.1} 

26 

27 // Task 实现 Worker 接口 

28 func (m *namePrinter) Task() { 
29 log.Println (m.name) 

30 time.Sleep (time.Second) 

3 /二 


在 代码 清单 7-35 的 第 23 行 , 声明 了 namePrinter 类 型 , 接着 是 这 个 类 型 对 Worker 接口 
的 实现 。 这 个 类 型 的 工作 任务 是 在 显示 器 上 显示 名 字 。 这 个 类 型 只 包含 一 个 字段 ， 即 name， 它 
包含 要 显示 的 名 字 。Worker 接口 的 实现 Task 函数 用 lo0g .Println 函数 来 显示 名 字 ， 之 后 等 
待 1 秒 再 退出 。 等 待 这 1 秒 只 是 为 了 让 测试 程序 运行 的 速度 慢 一 些 ， 以 便 看 到 并 发 的 效果 。 

有 了 Worker 接口 的 实现 ， 我 们 就 可 以 看 一 下 main 函数 内 部 的 代码 了 ， 如 代码 清单 7-36 
所 示 。 





代码 清单 7-36 ”work/main/main.go: 第 33 行 到 第 64 行 


33 // main 是 所 有 Go 程序 的 入 口 











34 func main() { 

35 // 使 用 两 个 goroutine 来 创建 工作 池 
36 p := work.New (2) 

37 

38 Var wg sync.WaitGroup 


39 wg.Add(100 * len (names)) 












































41 fo 二 0 T0037. tt -4 

42 // 迭代 names 切片 

43 for , name := range names { 

44 // 创建 一 个 namePrinter 并 提供 
45 // 指定 的 名 字 

46 np := namePrintert{ 

47 name: name, 

48 } 

49 

50 go func() { 

51 // 将 任务 提交 执行 。 当 Run 返回 时 
52 // 我 们 就 知道 任务 已 经 处 理 完成 
Lae p.Run (&np) 

54 wg .Done () 

55 }() 

56 } 

353 4 

58 

S59 wg .Wait () 

60 

61 // 让 工作 池 停 止 工作 ， 等 待 所 有 现 有 的 

62 // 工作 完成 

63 P.Shutaown () 

64 } 


在 代码 清单 7-36 第 36 行 , 调用 work 包 里 的 New 函数 创建 一 个 工作 池 。 这 个 调用 传人 的 参 
数 是 2， 表示 这 个 工作 池 只 会 包含 两 个 执行 任务 的 goroutine。 在 第 38 行 和 第 39 行 , 声明 了 一 个 
WaitGroup，, 并 初始 化 为 要 执行 任务 的 goroutine 数 。 在 这 个 例子 里 , names 切片 里 的 每 个 名 字 
都 会 创建 100 个 goroutine 来 提交 任务 。 这样 就 会 有 一 堆 goroutine 互相 竞争 , 将 任务 提交 到 池 里 。 

在 第 41 行 到 第 43 行 ， 内 部 和 外 部 的 for 循环 用 来 声明 并 创建 所 有 的 goroutine。 每 次 内 部 
循环 都 会 创建 一 个 namePrinter 类 型 的 值 ， 并 提供 一 个 用 来 打印 的 名 字 。 之 后 ， 在 第 50 行 ， 
声明 了 一 个 匿名 也 数 ， 并 创建 一 个 goroutine 执行 这 个 函数 。 这 个 goroutine 会 调用 工作 池 的 Run 
方法 ,将 namePrinter 的 值 提交 到 池 里 。 一 旦 工作 池 里 的 goroutine 接收 到 这 个 值 ，Run 方法 
就 会 返回 。 这 也 会 导致 goroutine 将 WaitGroup 的 计数 递减 ， 并 终止 goroutine。 

一 旦 所 有 的 goroutine 都 创建 完成 ， main 函数 就 会 调用 WaitGroup 的 Wait 方法 。 这 个 调 
用 会 等 待 所 有 创建 的 goroutine 提交 它们 的 工作 ,一 旦 Wait 返回 , 就 会 调用 工作 池 的 Shut down 
方法 来 关闭 工作 池 。Shut qown 方法 直到 所 有 的 工作 都 做 完 才 会 返回 。 在 这 个 例子 里 , 最 多 只 会 
等 待 两 个 工作 的 完成 。 



























































XX 小 结 


国 可 以 使 用 通道 来 控制 程序 的 生命 周期 。 
国 带 dqefault 分 支 的 select 语句 可 以 用 来 尝试 向 通道 发 送 或 者 接收 数据 ， 而 不 会 阻塞 。 


























有 缓冲 的 通道 可 以 用 来 管理 一 组 可 复 用 的 资源 。 

语言 运行 时 会 处 理 好 通道 的 协作 和 同步 。 

使 用 无 缓冲 的 通道 来 创建 完成 工作 的 goroutine 池 。 

任何 时 间 都 可 以 用 无 缓冲 的 通道 来 让 两 个 goroutine 交换 数据 , 在 通道 操作 完成 时 一 定 保 
证 对 方 接收 到 了 数据 。 





























本 章 主要 内 容 

输出 数据 以 及 记录 日 志 

对 JSON 进行 编码 和 解码 

处 理 输入 /输出 ， 并 以 流 的 方式 处 理 数 据 
让 标准 库 里 多 个 包 协 同 工 作 











什么 是 Go 标准 库 ? 为 什么 这 个 库 这 么 重要 ? Go 标准 库 是 一 组 核心 包 ， 用 来 扩展 和 增强 语 
言 的 能 力 。 这 些 包 为 语言 增加 了 大 量 不 同 的 类 型 。 开 发 人 员 可 以 直接 使 用 这 些 类 型 ， 而 不 用 再 写 
自己 的 包 或 者 去 下 载 其 他 人 发 布 的 第 三 方 包 。 由 于 这 些 包 和 语言 绑 在 一 起 发 布 , 它们 会 得 到 以 下 
特殊 的 保证 : 

国 每 次 语言 更 新 ， 哪 怕 是 小 更 新 ， 都 会 带 有 标准 库 ; 
这 些 标准 库 会 严格 遵守 向 后 兼容 的 承诺 ; 
标准 库 是 Go 语言 开发 、 构 建 、 发 布 过 程 的 一 部 分 ; 
标准 库 由 Go 的 构建 者 们 维护 和 评审 ; 
每 次 Go 语言 发 布 新 版 本 时 ， 标 准 库 都 会 被 测试 ， 并 评估 性 能 。 

这 些 保证 让 标准 库 变 得 很 特殊 , 开发 人 员 应 该 尽量 利用 这 些 标准 库 。 使 用 标准 库 里 的 包 可 以 
使 管理 代码 变 得 更 容易 ， 并 且 保 证 代码 的 稳定 。 不 用 担心 程序 无 法 兼容 不 同 的 Go 语言 版 本 ， 也 
不 用 管理 第 三 方 依赖 。 

如 果 标 准 库 包含 的 包 不 够 好 用 ， 那 么 这 些 好 处 实际 上 没什么 用 。Go 语言 社区 的 开发 者 会 比 
其 他 语言 的 开发 者 更 依赖 这 些 标准 库 里 的 包 的 原因 是 , 标准 库 本 吴 是 经 过 良好 设计 的 , 并 且 比 其 
他 语言 的 标准 库 提供 了 更 多 的 功能 。 社 区 里 的 Go 开发 者 会 依赖 这 些 标准 库 里 的 包 做 更 多 其 他 语 
言 中 开发 者 无 法 做 的 事情 ， 例 如， 网 络 、HTTP、 图 像 处 理 、 加 密 等 。 

本 章 中 我 们 会 大 至 了解 标 准 库 的 一 部 分 包 。 之 后 ， 我 们 会 更 详细 地 探讨 3 个 非常 有 用 的 包 : 
1og、json 和 io。 这 些 包 也 展示 了 Go 语言 提供 的 重要 且 有 用 的 机 制 。 

































































































































































Xse 文档 与 源 代码 


标准 库 里 包含 众多 的 包 ， 不 可 能 在 一 章 内 把 这 些 包 都 讲 一 遍 。 目 前 ， 标 准 库 里 总 共有 超过 
100 个 包 ， 这 些 包 被 分 到 38 个 类 别 里 ， 如 代码 清单 8-1 所 示 。 


代码 清单 8-1 标准 库 里 的 项 级 目录 和 包 





archive bufio bytes compress container crypto database 
debug encoding errors expvar flag fmt go 

hash html image index io log math 
mime net os path reflect regexp runtime 
sort strconv strings sync syscall testing text 
time unicode unsafe 





代码 清单 8-1 里 列 出 的 许多 分 类 本 身 就 是 一 个 包 。 如 果 想 了 解 所 有 包 以 及 更 详细 的 描述 ，Go 
语言 团队 在 网 站 上 维护 了 一 个 文档 ， 参 见 http://golang.org/pkg/。 

golang 网 站 的 pkg 页 面 提供 了 每 个 包 的 godoc 文档 。 图 8-1 展示 了 golang 网 站 上 io 
包 的 文档 。 








type Writer 


type Writer interface { 
Write(p []byte) (n int，err error) 
} 


Writer is the interface that wraps the basic Write method. 


Write writes len(p) bytes from p to the underlying data stream. lt returns the number of bytes written from p (0 <: 
ifit returns n < len(p). Write must not modify the slice data, even temporarily, 














图 8-1 golang.org/pkg/io/#AN riter 





如 果 想 以 交互 的 方式 浏览 文档 ，Sourcegraph 索引 了 所 有 标准 库 的 代码 ， 以 及 大 部 分 包含 Go 
代码 的 公开 库 。 图 8-2 是 Sourcegraph 网 站 的 一 个 例子 ， 展 示 的 是 io 包 的 文档 。 


Writer 


tain p, Writerisi 


，err error) Write writ 








图 8-2 sourcegraph.com/code.google.com/p/go/.GoP ackage/io/.def/W riter 


不 管用 什么 方式 安装 Go， 标 准 库 的 源 代码 都 会 安装 在 $6GOROOT/src/pkg 文件 夹 中 。 拥 有 标 
准 库 的 源 代码 对 Go 工具 正常 工作 非常 重要 。 类 似 godoc 、gocode 甚至 go build 这 些 工具 ， 
都 需要 读 取 标准 库 的 源 代码 才能 完成 其 工作 。 如 果 源 代码 没有 安装 在 以 上 文件 夹 中 , 或 者 无 法 通 























过 $GOROOT 变量 访问 ， 在 试图 编译 程序 时 会 产生 错误 。 

作为 Go 发 布 包 的 一 部 分 ,标准 库 的 源 代码 是 经 过 预 编译 的 。 这 些 预 编译 后 的 文件 ， 称 作为 
档 文件 (archive file )， 邑 / 在 $GOROOT/pkg 文件 夹 中 找到 已 经 安装 的 各 目标 平台 和 操作 系统 的 
归档 文件 。 在 图 8-3 里 ， 可 以 看 到 扩展 名 是 .a 的 文件 ， 这 些 就 是 归档 文件 。 




















图 8-3 ”pkg 文件 夹 中 的 归档 文件 的 文件 夹 的 视图 


这 些 文件 是 特殊 的 Go 静态 库 文件 ， 由 Go 的 构建 工具 创建 ， 并 在 编译 和 链接 最 终 程 序 时 被 
使 用 。 归 档 文件 可 以 让 构建 的 速度 更 快 。 但 是 在 构建 的 过 程 中 , 没 办 法 指定 这 些 文件 ， 所 以 没 办 
法 与 别人 共享 这 些 文件 。Go 工具 链 知 道 什么 时 候 可 以 使 用 已 有 的 .a 文件 ， 什 么 时 候 需 要 从 机 絮 
上 的 源 代码 重新 构建 。 

有 了 这 些 背景 知识 , 让 我 们 看 一 下 标准 库 里 的 几 个 包 , 看 看 如 何 用 这 些 包 来 构建 自己 的 程序 。 












































Xeae 记录 日 志 


即便 没有 表现 出 来 ， 你 的 程序 依旧 可 能 有 bug。 这 在 软件 开发 里 是 很 自然 的 事情 。 日 志 是 一 
种 找到 这 些 bug， 更 好 地 了 解 程序 工作 状态 的 方法 。 日 志 是 开发 人 员 的 眼睛 和 耳 人 条 ， 可 以 用 来 跟 
踪 、 调 试 和 分 析 代 码 。 基 于 此 ， 标 准 库 提供 了 1log 包 ， 可 以 对 日 志 做 一 些 最 基本 的 配置 。 根 据 
特殊 需要 ， 开 发 人 员 还 可 以 自己 定制 日 志 记录 器 。 

在 UNIX 里 ， 日 志 有 很 长 的 历史 。 这 些 积 累 下 来 的 经 验 都 体现 在 1og 包 的 设计 里 。 传 统 的 
CLI (命令 行 界面 ) 程序 直接 将 输出 写 到 名 为 stdout 的 设备 上 。 所 有 的 操作 系统 上 都 有 这 种 设 
备 , 这 种 设备 的 默认 目的 地 是 标准 文本 输出 。 默 认 设 置 下 , 终端 会 显示 这 些 写 到 stdout 设备 上 
的 文本 。 这 种 单个 目的 地 的 输出 用 起 来 很 方便 , 不 过 你 总 会 碰 到 需要 同时 输出 程序 信息 和 输出 执 
行 细节 的 情况 。 这 些 执行 细节 被 称 作 日 志 。 当 想 要 记录 日 志 时 , 你 希望 能 写 到 不 同 的 目的 地 ,这 
样 就 不 会 将 程序 的 输出 和 日 志 混 在 一 起 了 。 

为 了 解决 这 个 问题 UNIX 架构 上 增加 了 一 个 叫 作 stderzr 的 设备 。 这 个 设备 被 创建 为 日 志 
的 默认 目的 地 。 这 样 开 发 人 员 就 能 将 程序 的 输出 和 日 志 分 离开 来 。 如 果 想 在 程序 运行 时 同时 看 型 
程序 输出 和 日 志 ， 可 以 将 终端 配置 为 同时 显示 写 到 stdout 和 stgerr 的 信息 。 不 过 ， 如 果 用 
户 的 程序 只 记录 日 志 , 没有 程序 输出 ,更 常用 的 方式 是 将 一 般 的 日 志 信 息 写 到 stdout ， 将 错误 
或 者 警告 信息 写 到 st derr。 
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8.2.1 log 包 


让 我 们 从 log 包 提 供 的 最 基本 的 功能 开始 ， 之 后 再 学 习 如 何 创 建 定制 的 日 志 记 录 器 。 记 录 
日 志 的 目的 是 跟踪 程序 什么 时 候 在 什么 位 置 做 了 什么 。 这 就 需要 通过 某 些 配 置 在 每 个 日 志 项 上 要 
写 的 一 些 信息 ， 如 代码 清单 8-2 所 示 。 














代码 清单 8-2 ”跟踪 日 志 的 样 例 
TRACE : 2009/11/10 23:00:00.000000 /tmpfs/gosandbox-/prog.g0:14: message 
在 代码 清单 8-2 中 , 可 以 看 到 一 个 由 1og 包产 生 的 日 志 项 。 这 个 日 志 项 包含 前 缀 、 日 期 时 间 
惟 、 该 日 志 具 体 是 由 哪个 源 文件 记录 的 、 源 文件 记录 日 志 所 在 行 ， 最 后 是 日 志 消 息 。 让 我 们 看 一 
下 如 何 配置 1og 包 来 输出 这 样 的 日 志 项 ， 如 代码 清单 8-3 所 示 。 


代码 清单 8-3 listing03.go 


01 // 这 个 示例 程序 展示 如 何 使 用 最 基本 的 1og 包 
02 Package main 
























































03 

04 import ( 

05 ee 有 

06 ) 

07 

08 func init () { 

09 1og.SetPrefix("ITRACE: ") 

10 log.SetFlags (log.Ldate | log.Lmicroseconds log.Llongfile) 
i 

12 

13 func main() { 

14 // Println 写 到 标准 日 志 记 录 器 

15 log.Println ("message") 

16 

17 // Fatalln 在 调用 Println() 之 后 会 接着 调用 os .Exit (1) 
18 log.Fatalln ("fatal message") 

.9 

20 // Panicln 在 调用 Println() 之 后 会 接着 调用 panic () 

2 log.Panicln ("panic message") 

22 } 


如 果 执 行 代码 清单 8-3 中 的 程序 ， 输 出 的 结果 会 和 代码 清单 8-2 所 示 的 输出 类 似 。 让 我 们 分 
析 一 下 代码 清单 8-4 中 的 代码 ， 看 看 它 是 如 何 工 作 的 。 





代码 清单 8-4 listing03.go: 第 08 行 到 第 11 行 


08 func init () { 

09 1og.SetPrefix("ITRACE: ") 

10 log.SetFlags (log.Ldate | log.Lmicroseconds | log.Llongfile) 
生计 下水 


在 第 08 行 到 第 11 行 ， 定 义 的 函数 名 为 init () 。 这 个 函数 会 在 运行 main () 之 前 作为 程序 


初始 化 的 一 部 分 执行 。 通 常 程序 会 在 这 个 init ( i 这 样 程序 一 开始 就 能 

















用 log 包 进 行 正确 的 输出 。 在 这 段 程序 的 第 9 行 , 设置 了 一 个 字符 串 ， 作为 每 个 日志 帝 的 且 疯 。 
这 个 字符 串 应 该 是 能 让 用 户 从 一 般 的 程序 输出 中 分 辨 出 0 传统 上 这 个 字符 串 的 字 
符 会 全 部 大 写 。 


有 几 个 和 log 包 相 关联 的 标志 ， 这 些 标志 用 来 控制 可 以 写 到 每 个 日 志 项 的 其 他 信息 。 代 码 
清单 8-5 展示 了 目前 包含 的 所 有 标志 。 


代码 清单 8-5 golang.org/src/log/log.go 


Const ( 
// 将 下 面 的 位 使 用 或 运算 符 连 接 在 一 起 ， 可 以 控制 要 输出 的 信息 。 没 有 
// 办 法 控制 这 些 信 息 出 现 的 ) 顺序 (下 面 会 给 出 顺序 ) 或 者 打印 的 格式 
// 格式 在 注释 里 描述 ) 。 这 些 项 后 面 会 有 一 个 冒号 : 
wp 2009/01/23 01:23:23.123123 /a/b/c/d.go:23: message 













































































A 月 : 2009/01/23 
Ldate = 1 << iota 























// 时 间 : 01:23:23 
Ltime 





// 毫秒 级 时 间 : 01:23:23.123123。 该 设置 会 覆盖 Ltime 标志 
Lmicroseconds 





// 完整 路 径 的 文件 名 和 行 号 : /a/b/c/d.go:23 
Llongfile 





// 最 终 的 文件 名 元 素 和 行 号 : d.go:23 
// 禾 盖 Llongfile 
Lshortfile 

















// 标准 日 志 记录 器 的 初始 值 
LstdFlags = Ldate | Ltime 














) 
代码 清单 8-5 是 从 1og 包 里 直接 摘抄 的 源 代码 。 这些 标志 被 声明 为 常量 , 这 个 代码 块 中 的 第 
一 个 常量 叫 作 Ldate， 使 用 了 特殊 的 语法 来 声明 ， 如 代码 清单 8-6 所 示 。 


代码 清单 8-6 ”声明 Ldate 常量 


// 日 期 : 2009/01/23 
Ldate = 1 << iota 


关键 字 iota 在 常量 声明 区 里 有 特殊 的 作用 。 这 个 关键 字 让 编译 需 为 每 个 常量 复制 相同 的 表 

达 式 ， 直 到 声明 区 结束 ， 或 者 遇 到 一 个 新 的 赋值 语句 。 关 键 字 iot a 的 另 一 个 功能 是 ，iota 的 

初始 值 为 0， 之 后 iota 的 值 在 每 次 处 理 为 常量 后 ， 都 会 自 增 1。 让 我 们 更 仔细 地 看 一 下 这 个 关 
键 字 ， 如 代码 清单 8-7 所 示 。 




















代码 清单 8-7 使 用 关键 字 iota 


Genmst 
Ldate = 1 << iota // 1 << 0= 000000001 = 1 
Ltime // 1<<1= 000000010 = 2 
Lmicroseconds // 1 <<2= 000000100 = 4 
Llongfile // 1 << 3= 000001000 = 8 
Lshortfile // 1 <<4= 000010000 = 16 





) 

代码 清单 8-7 展示 了 常量 声明 背后 的 处 理 方法 。 操 作 符 << 对 左边 的 操作 数 执行 按 位 左 移 操 
作 。 在 每 个 常量 声明 时 ， 都 将 1 按 位 左 移 iota 个 位 置 。 最终 的 效果 使 为 每 个 常量 赋予 一 个 独立 
位 置 的 位 ， 这 正好 是 标志 希望 的 工作 方式 。 

常量 LstdFlags 展示 了 如 何 使 用 这 些 标 志 ， 如 代码 清单 8-8 所 示 。 


代码 清单 8-8 ”声明 LstdFlags 常量 
const ( 


LstdFlags = Ldate(1) | Ltime(2) = 00000011 = 3 
) 


在 代码 清单 8-8 中 看 到 ， 因 为 使 用 了 复制 操作 符 ，LstaFlags 打破 了 iota 常数 链 。 由 于 
有 | 运算 符 用 于 执行 或 操作 ， 常 量 LstdF1lags 被 赋值 为 3。 对 位 进行 或 操作 等 同 于 将 每 个 位 置 
的 位 组 合 在 一 起 ， 作 为 最 终 的 值 。 如 果 对 位 1 和 2 进行 或 操作 ， 最 终 的 结果 就 是 3。 

让 我 们 看 一 下 我 们 要 如 何 设置 日 志 标志 ， 如 代码 清单 8-9 所 示 。 





代码 清单 8-9 listing03.go: 第 08 行 到 第 11 行 


08. func, Tnit() A 

09 i 

10 log.SetFlags (log.Ldate | log.Lmicroseconds | log.Llongfile) 
Ey 


这 里 我 们 将 Ldate、Lmicroseconds 和 Llongfile 标志 组 合 在 一 起 , 将 该 操作 的 值 传人 
SetFlags 子 数 。 这 些 标志 值 组 合 在 一 起 后 ,最 终 的 值 是 13, 代表 第 1、3 和 4 位 为 1 (00001101 )。 
由 于 每 个 常量 表示 单独 一 个 位 , 这些 标 志 经 过 或 操作 组 合 后 的 值 , 可 以 表示 每 个 需要 的 日 志 参 数 。 
之 后 109 包 会 按 位 检查 这 个 传 入 的 整数 值 ， 按 照 需求 设置 日 志 项 记录 的 信息 。 

初始 完 1og 包 后 ， 可 以 看 一 下 main () 函数 ， 看 它 是 是 如 何 写 消息 的 ， 如 代码 清单 8-10 所 示 。 








代码 清单 8-10 listing03.go: 第 13 行 到 第 22 行 














13 func main() { 

14 // Println 写 到 标准 日 志 记 录 器 

15 log.Println ("message") 

16 

17 // Fatalln 在 调用 Println() 之 后 会 接着 调用 os .Exit (1) 











18 log.Fatalln ("fatal message") 






































二 9 

20 // Panicln 在 调用 Println() 之 后 会 接着 调用 panic () 

2 并 1og.Panicln("panic message") 

ZZ} 

代码 清单 8-10 展示 了 如 何 使 用 3 个 函数 Println、Fatalln 和 Panicln 来 写 日 志 消 息 。 





这 Cn 息 的 版 本 ， 只 需要 用 £ 替换 结尾 的 In。Fatal 系列 函数 用 来 写 日 志 
消息 ,然后 使 用 os .Exit (1) 终 止 程序 Panic 系列 函数 用 来 写 日 志 消 息 , 然 后 触发 一 个 panic。 
除非 程序 执行 recover 函数 ,否则 会 导致 程 序 打印 调用 栈 后 终止 。 Print 系列 函数 是 写 日 志 消 
息 的 标准 方法 。 

log 包 有 一 个 很 方便 的 地 方 就 是 ， 这 些 日 志 记录 器 是 多 goroutine 安全 的 。 这 意味 着 在 多 个 
goroutine 可 以 同时 调用 来 自 同一 个 日 志 记 录 器 的 这 些 函 数 ， 而 不 会 有 彼此 间 的 写 冲突 。 标准 日 志 
记录 咒 具 有 这 一 性 质 ， 用 户 定制 的 日 志 记 录 咒 也 应 该 满足 这 一 性 质 。 

现在 知道 了 如 何 使 用 和 配置 1og 包 ， 让 我 们 看 一 下 如 何 创 建 一 个 定制 的 日 志 记 录 器 ， 以 便 
可 以 让 不 同等 级 的 日 志 写 到 不 同 的 目的 地 。 

















8.2.2 ”定制 的 日 志 记录 器 


要 想 创 建 一 个 定制 的 日 志 记录 器 , 需要 创建 一 个 Logger 类 型 值 。 可 以 给 每 个 日 志 记 录 带 配 
置 一 个 单独 的 目的 地 ,并 独立 设置 其 前 级 和 标志 。 让 我 们 来 看 一 个 示例 程序 ， 这 个 示例 程序 展示 
了 如 何 创 建 不 同 的 Logger 类 型 的 指针 变量 来 支持 不 同 的 日 志 等 级 ， 如 代码 清单 8-11 所 示 。 


代码 清单 8-11 listing11.9o 


01 // 这 个 示例 程序 展示 如 何 创建 定制 的 日 志 记录 器 


02 Package main 




































































03 

04 import (人 

95 和 

06 "io/ioutil" 

07 "log" 

08 "os™ 

09 ) 

10 

11 var ( 

2 Trace  ”*]log.Logger // 记录 所 有 日 志 

3 Info *]og.Logger // 重要 的 信息 

4 Warning xlog.Logger // 需要 注意 的 信息 

5 Error ”*log.Logger // 非常 严重 的 问题 

16 ) 

这 

8 func init () { 

19 file, err := os.OpenFile("errors.txt", 
20 0s.0_CREATE |os.0 WRONLY |os.0 APPEND, 0666) 
21 if err != nil { 


22 log.Fatalln ("Failed to open error log file:" err) 














23 } 

24 

25 Trace = log.New(ioutil.Discargd, 

26 TRAGCES 

2 log.Ldate|log.Ltime|log.Lshortfile) 

28 

29 Info = log.New(os.Stdout, 

30 INEOS ™ 

仿 让 log.Ldate|log.Ltime|log.Lshortfile) 

32. 

3:3 Warning = log.New(os.Stdout, 

34 "WARNING: "v 

35 log.Ldate|log.Ltime|log.Lshortfile) 

36 

3 Error = log.New(io.MultiWriter (file, os.Stderr), 
38 “ERROR "> 

39 log.Ldate|log.Ltime|log.Lshortfile) 

40 } 

41 

42 func main() { 

43 Trace.Println("I have something standard to say") 
44 Info.Println("Special Information") 

45 Warning.Printlin("There is something you need to know about") 
46 Error.Println("Something has failed") 

47 } 


代码 清单 8-11 展示 了 一 段 完整 的 程序 ， 这 有 段 程序 创建 了 4 种 不 同 的 Logger 类 型 的 指针 变 
量 , 分别 命名 为 Trace 、Info、Warning 和 Error。 每 个 变量 使 用 不 同 的 配置 ， 用 来 表示 不 
同 的 重要 程度 。 让 我 们 来 分 析 一 下 这 段 代 码 是 如 何 工作 的 。 

在 第 11 行 到 第 16 行 , 我 们 为 4 个 日 志 等 级 声明 了 4 个 Logger 类 型 的 指针 变量 , 如 代码 清 
单 8-12 所 示 。 


























代码 清单 8-12 listing11.go: 第 11 行 到 第 16 行 












































11 Var ( 

12 Trace  ”*log.Logger // 记录 所 有 日 志 
3 Info *]log.Logger // 重要 的 信息 

14 Warning xlog.Logger // 需要 注意 的 信息 
15 Error  ”*log.Logger // 非常 严重 的 问题 
16 ) 


在 代码 清单 8-12 中 可 以 看 到 对 Logger 类 型 的 指针 变量 的 声明 。 我们 使 用 的 变量 名 很 简短 ， 
但 是 含义 明确 。 接 下 来 , 让 我 们 看 一 下 init () 函数 的 代码 是 如 何 创 建 每 个 Logger 类 型 的 值 并 
将 其 地 址 赋 给 每 个 变量 的 ， 如 代码 清单 8-13 所 示 。 


代码 清单 8-13 listing11.go: 第 25 行 到 第 39 行 





25 Trace = log.New(ioutil.Discargd, 
26 TRAGES. 1 
27 log.Ldate|lo0g.Ltime log.Lshortfile) 


29 Info = log.New(os.Stdout, 

30 PINEOS Ty 

3 log.Ldate|log.Ltime log.Lshortfile) 
2 

3 Warning = log.New(os.Stdout, 

34 "WARNING: "v 

35 log.Ldate|1lo0g.Ltime log.Lshortfile) 
36 

37 Error = log.New(io.MultiWriter (file, os.Stderr), 
38 "ERROR: "™, 

39 log.Ldate|log.Ltime|log.Lshortfile) 


为 了 创建 每 个 日 志 记录 器 ,我们 使 用 了 log 包 的 New 函数 ， 它 创建 并 正确 初始 化 一 个 
Logger 类 型 的 值 。 函 数 New 会 返回 新 创建 的 值 的 地 址 。 在 New 函数 创建 对 应 值 的 时 候 ， 我 们 
给 它 传 入 一 些 参 数 ， 如 代码 清单 8-14 所 示 。 





代码 清单 8-14 golang.org/src/log/log.go 
// Nevw 创建 一 个 新 的 Logger。 out 参数 设置 日 志 数 据 将 被 写 入 的 目的 地 



































// 参数 prefix 会 在 生成 的 每 行 日 志 的 最 开始 出 现 

// 参数 flag 定义 日 志 记 录 包 含 哪 些 属性 

func New(out io.Writer, prefix string, flag int) *Logger { 
return &Logger{out: out, prefix: prefix, flag: flag} 




















} 
代码 清单 8-14 展示 了 来 自 109 包 的 源 代码 里 的 New 函数 的 声明 。 第 一 个 参数 out 指定 了 
日 志 要 写 到 的 目 os 这 个 参数 传人 的 值 必须 实现 了 io .Writer 接口。 第 二 个 参数 prefix 是 
之 前 看 到 的 前 级 ， 而 日 志 的 标志 则 是 最 后 一 个 参数 。 
0 Trace 日志 记 录 带 使 用 了 ioutil 包 里 的 Discard 变量 作为 写 到 的 目的 地 ， 
如 代码 清单 8-15 所 示 。 

















代码 清单 8-15 listing11.go: 第 25 行 到 第 27 行 





25 Trace = log.New(ioutil.Discargd, 
26 TTRAGES .0 
之 了 log.Ldate|log.Ltime|log.Lshortfile) 








变量 Discard 有 一 些 有 意思 的 属性 ， 如 代码 清单 8-16 所 示 。 


代码 清单 8-16 golang.org/src/io/ioutil/ioutil.go 


// devNull 是 一 个 用 int 作为 基础 类 型 的 类 型 
type devNull int 











// Discard 是 一 个 io.Writer， 所 有 的 write 调用 都 不 会 有 动作 ， 但 是 会 成 功 返 回 


Var Discard io.Writer = devNull (0) 

















// io.Writer 接口 的 实现 
func (devNull) Write(P [lbyte) (int, error) { 





return len(p), nil 


} 


代码 清单 8-16 展示 了 Discard 变量 的 声明 以 及 相关 的 实现 。Discard 变量 的 类 型 被 声明 
为 io.Writer 接口 类 型 ， 并 被 给 定 了 一 个 devNull 类 型 的 值 0。 基 于 devNull 类 型 实现 的 
Write 方法 , 会 忽略 所 有 写 入 这 一 变量 的 数据 。 当 某 个 等 级 的 日 志 不 重要 时 , 使 用 Discard 变 
量 可 以 禁用 这 个 等 级 的 日 志 。 
日 志 记 录 天 Info 和 Warning 都 使 用 st qout 作为 日 志 输出 ， 如 代码 清单 8-17 所 示 。 





代码 清单 8-17 listing11.go: 第 29 行 到 第 35 行 


29 Info = log.New(os.Stdout, 

30 TNEOS ”7 

3 二 log.Ldate|lo0g.Ltime log.Lshortfile) 
32 

33 Warning = log.New(os.Stdout, 

34 "WARNING: "v 

35 log.Ldate|log.Ltime|log.Lshortfile) 


变量 St dout 的 声明 也 有 一 些 有 意思 的 地 方 ， 如 代码 清单 8-18 所 示 。 





代码 清单 8-18 golang.org/src/os/file.go 
// Stdin、Stdout 和 stgerr 是 已 经 打开 的 文件 ， 分 别 指向 标准 输入 、 标 准 输出 和 
































// 标准 错误 的 文件 描述 符 


Var ( 
Stdin = NewFile(uintptr(syscall.Stdin), "/dev/stdin") 
Stdout = NewFile(uintptr(syscall.Stdout), "/dev/stdout") 
Stderr = NewFile(uintptr(syscall.Stderr), "/dev/stderr") 


) 
os/file unix.go 


// NewFile 用 给 出 的 文件 描述 符 和 名 字 返 回 一 个 新 File 


func NewFile(fd uintptr, name string) *File { 

在 代码 清单 8-18 中 可 以 看 到 3 个 变量 的 声明 ， 分别 表示 所 有 操作 系统 里 都 有 的 3 0 
入 /输出 , 即 stdin 、stdout 和 stderr。 这 3 个 变量 都 被 声明 为 File 类 型 的 指针 ,这 个 类 型 
实现 了 io.Writer 接口 。 有 了 这 个 知识 , 我 们 来 看 一 下 最 后 的 日 志 记 录 器 Error， ne 青 单 
8-19 所 示 。 








代码 清单 8-19 listing11.go: 第 37 行 到 第 39 行 





37 Error = log.New(io.MultiWriter (file, os.Stderr), 
38 "ERROR: ™, 
3.9 log.Ldate|log.Ltime|log.Lshortfile) 


在 代码 清单 8-19 中 可 以 看 到 New 函数 的 第 一 个 参数 来 自 一 个 特殊 的 函数 。 这 个 特殊 的 函数 
就 是 ie 包 里 的 Multiwriter 也 数 ， 如 代码 清单 8-20 所 示 。 





代码 清单 8-20 包 io 里 的 MultiWriter 函数 的 声明 
io.MultiNWriter (file，os.StdqerL) 
代码 清单 8-20 单独 展示 了 MultiWwriter 函数 的 调用 。 这 个 函数 调用 会 返回 一 个 io .Writer 
接口 类 型 值 ， 这 个 值 包含 之 前 打开 的 文件 file， 以 及 stderr。MultiWriter 函数 是 一 个 变 参 函 
数 , 可 以 接受 任意 个 实现 了 io.Writer 接口 的 值 。 这 个 函数 会 返回 一 个 io .Writez 值 , 这 个 值 会 
把 所 有 传人 的 io.Writer 的 值 绑 在 一 起 。 当 对 这 个 返回 值 进行 写 人 时 ， 会 向 所 有 绑 在 一 起 的 
io.Writer 值 做 写 入 。 这 让 类 似 1og.Nevw 这 样 的 函数 可 以 同时 向 多 个 Writer 做 输出 。 现 在 ， 当 


我 们 使 用 Error 记录 器 记录 日 志 时 ， 输 出 会 同时 写 到 文件 和 stderr。 
现在 知道 了 该 如 何 创 建 定制 的 记录 器 了 ， 让 我 们 看 一 下 如 何 使 用 这 些 记录 器 来 写 日 志 消 息 ， 
如 代码 清单 8-21 所 示 。 











代码 清单 8-21 listing11.go: 第 42 行 到 第 47 行 


42 func main() { 

43 Trace.Println("I have something standard to say") 

44 Info.Println("Special Information") 

45 Warning.Println("There is something you need to know about") 
46 Error.Println("Something has failed") 

47 } 


代码 清单 8-21 展示 了 代码 清单 8-11 中 的 main () 函数 。 在 第 43 行 到 第 46 行 ， 我 们 用 自己 
创建 的 每 个 记录 器 写 一 条 消息 。 每 个 记录 器 变量 都 包含 一 组 方法 ， 这 组 方法 与 10g 包 里 实现 的 
那 组 函数 完全 一 致 ， 如 代码 清单 8-22 所 示 。 

代码 清单 8-22 展示 了 为 Logger 类 型 实现 的 所 有 方法 。 





代码 清单 8-22 ”不同 的 日 志方 法 的 声明 


func (1 *Logger) Fatall(lv ...interface{}) 
func (1 *Logger) Fatalf (format string, Vv ...interface{}) 
func (1 *Logger) Fatalln(v ...interface{}) 


func (1 *Logger) Flags() int 
func (1 *Logger) Output (calldepth int, s string) error 








func (1 *Logger) Panicl(v ...interface{}) 

func (1 *Logger) Panicf (format string, Vv ...interface{}) 
func (1 *Logger) Paniclnl(v ...interface{}) 

func (1 *Logger) Prefix() string 

func (1 *Logger) Print(v ...interface{}) 

func (1 *Logger) Printf(format string, Vv ...interface{}) 
func (1 *Logger) Println(v ...interface{}) 

func (1 *Logger) SetFlags (flag int) 

func (1 *Logger) SetPrefix(prefix string) 


log 包 的 实现 ， 是 基于 对 记录 日 志 这 个 需求 长 时 间 的 实践 和 积累 而 形成 的 。 将 输出 写 到 


stdout, 将 日 志 记 录 到 st derr， 是 很 多 基于 命令 行 界面 (CLI ) 的 程序 的 惯常 使 用 的 方法 。 不 
过 如 果 你 的 程序 只 输出 日 志 ， 那 么 使 用 stdout 、stqderr 和 文件 来 记录 日 志 是 很 好 的 做 法 。 

标准 库 的 10g 包 包 含 了 记录 日 志 需 要 的 所 有 功能 ， 推 荐 使 用 这 个 包 。 我 们 可 以 完全 信任 这 
个 包 的 实现 ， 不 仅仅 是 因为 它 是 标准 库 的 一 部 分 ， 而 且 社 区 也 泛 使 用 它 。 








XX ”编码 5 饰 码 


许多 程序 都 需要 处 理 或 者 发 布 数据 , 不 管 这 个 程序 是 要 使 用 数据 库 ， 进 行 网 络 调用 ,还 是 与 
分 布 式 系 统 打交道 。 如 果 程 序 需 要 处 理 XML 或 者 JSON， 可 以 使 用 标准 库 里 名 为 xml 和 json 
的 包 , 它们 可 以 处 理 这 些 格式 的 数据 。 如 果 想 实现 自己 的 数据 格式 的 编 解码 ， 可 以 将 这 些 包 的 实 
现 作为 指导 。 

在 今天 , JSON 远 比 XML 流行 。 这 主要 是 因为 与 XML 相 比 , 使 用 JSON 需要 处 理 的 标签 更 
少 。 而 这 就 意味 着 网 络 传输 时 每 个 消息 的 数据 更 少 ， 从 而 提升 整个 系统 的 性 能 。 而 且 ，JSON 可 
以 转换 为 BSON ( Binary JavaScript Object Notation， 二 进 制 JavaScript 对 象 标 记 )， 进 一 步 缩 小 每 
个 消息 的 数据 长 度 。 因 此 , 我 们 会 学 习 如 何在 Go 应 用 程序 里 处 理 并 发 布 JSON。 处 理 XML 的 方 
法 也 很 类 似 。 


8.3.1 解码 JSON 


我 们 要 学 习 的 处 理 JSON 的 第 一 个 方面 是 ,使 用 json 包 的 NewDecoder 限 数 以 及 Decodgde 
方法 进行 解码 。 如 果 要 处 理 来 自 网 络 响应 或 者 文件 的 JSON， 那 么 一 定 会 用 到 这 个 函数 及 方法 。 
夺 我 们 来 丰 - 中 入 理 Get 请 求 响应 的 JSON 的 例子 ,这 个 例子 使 用 http 包 获 取 Google 搜索 API 

返回 的 JSON。 代 码 清单 8-23 展示 了 这 个 响应 的 内 容 。 





代码 清单 8-23 Google 搜索 AP1 的] SON 响应 例子 


"responseData": { 
"results": [ 
{ 

"GsearchResultClass": "GwebSearch", 
"unescapedUrl": "https://www.reddit.com/r/golang", 
"url": "https://www.reddit.com/r/golang", 
"visibleUrl": "www.reddit.com", 
"cacheUrl": "http://www.google.com/search?q=cachei:W...", 
"title": "r/\u003cb\u003eGolang\u003c/b\u003e - Reddit", 
"titleNoFormatting": "r/Golang - Reddit", 
"content": "First Open Source \u003cb\u003eGolang\u..." 


"GsearchResultClass": "GwebSearch", 
"unescapedUrl": "http://tour.golang.org/", 


Murlts Thttp/7/tour olangorg/ 

"visibleUrl": "tour.golang.org", 

"cacheUrl": "http://www.google.com/search?q=cache:0O..."™, 
"title"; "A Tour of Go"y 

"titleNoFormatting": "A Tour of Go", 

"content": "Welcome to a tour of the Go programming ..." 


} 
代码 清单 8-24 给 出 的 是 如 何 获取 响应 并 将 其 解码 到 一 个 结构 类 型 里 的 例子 。 


代码 清单 8-24 listing24.go 


01 // 这 个 示例 程序 展示 如 何 使 用 json 包 和 NewDecoder 函数 
02 // 来 解码 JSON 响应 


03 package main 





























04 

05 import ( 

06 "encoding/json" 

07 下 下 

08 ee 

09 "net/http" 

10 ) 

入 

12 type ( 

3 // gResult 映射 到 从 搜索 拿 到 的 结果 文档 

14 gResult struct { 

ES GsearchResultClass string “json:"GsearchResultClass". 
6 UnescapedURL string ‘json:"unescapedUrl". 
URL StEing TJSonmn ur 
18 VisibleURL string ‘json:"visibleUrl". 
19 CacheURL string “Json: "eacheUreLE™ 

20 Title S 寸 芋 主 站 下- 人 可 SO 让 3 二 二 七 于 全 ”2 

21 TitleNoFormatting string “json:"titleNoFormatting". 

22 Content string “json:"content". 

23 } 

24 

25 // gResponse 包含 顶级 的 文档 

26 gResponse struct { 

7 ResponseData struct { 

28 Results []gResult ‘json:"results". 

29 } json:"responseData". 

30 } 

SD 

马公 

33 func main() { 

34 uri := "http://ajax.googleapis.com/ajax/services/search/web?v=1 .0&rsz=8&dq=golang" 

35 

36 // 向 Google 发 起 搜索 

37 resp, err := http.Get (uri) 

本 人 if err != nil { 


39 log.Println ("ERROR:", err) 


return 
} 
defer resp.Body.Close() 


// 将 JSON 响应 解码 到 结构 类 型 
Var gr gResponse 
err = json.NewDecoder (resp.Body) .Decode (&gr) 





‘OO PO 


if err != nil { 
log.Println ("ERROR:", err) 
return 
50 } 
Ss 
52 fmt .Println (gr) 
53. 


代码 清单 8-24 中 代码 的 第 37 行 ， 展示 了 程序 做 了 一 个 HTTP Get 调用 , 希望 从 Google 得 
到 一 个 JSON 文档, 之 后 ,在 第 46 行使 用 NewDecoder 函数 和 Decode 让 ,将 响应 返回 的 JSON 
文档 解码 到 第 26 行 声明 的 一 个 结构 类 型 的 变量 里 。 在 第 52 行 ， 将 这 个 变量 的 值 写 到 st dout。 

如 果 仔 细 看 第 26 行 和 第 14 行 的 gResponse 和 gResult 的 类 型 声明 ， 你 会 注意 到 每 个 字 
段 最 后 使 用 单 引号 声明 了 一 个 字符 串 。 这 些 字符 串 被 称 作 标 签 ( tag )， 是 提供 每 个 字段 的 元 信息 
的 一 种 机 制 , 将 JSON 文档 和 结构 类 型 里 的 字段 一 一 映射 起 来 。 如 果 不 存在 标签 ,编码 和 解码 过 
程 会 试图 以 大 小 写 无 关 的 方式 ， 直接 使 用 字段 的 名 字 进 行 匹配 。 如 果 无 法 匹配 ,对 应 的 结构 类 型 
里 的 字段 就 包含 其 零 值 。 

执行 HTTP Get 调用 和 解码 JSON 到 结构 类 型 的 具体 技术 细节 都 由 标准 库 包办 了 。 让 我 们 看 
一 下 标准 库 里 NewDecoder 函数 和 Decode 方法 的 声明 ， 如 代码 清单 8-25 所 示 。 



































代码 清单 8-25 ”golang.org/src/encoding/json/stream.go 
// NewDecoder 返回 从 上 读 取 的 解码 器 

















// 
// 解码 器 自己 会 进行 缓冲 ， 而 且 可 能 会 从 工读 比 解码 JSON 值 
// 所 需 的 更 多 的 数据 


func NewDecoder(r io.Reader) *Decoder 


















































// Decode 从 自己 的 输入 里 读 取 下 一 个 编码 好 的 JSON 值 ， 

// 并 存 入 v 所 指向 的 值 里 

// 

// 要 知道 从 JSON 转换 为 Go 的 值 的 细节 ， 

// 请 查看 Unmarshal 的 文档 

func (dec *Decoder) Decodel(lv interface{}) error 

在 代码 清单 8-25 中 可 以 看 到 NewDecoder 限 数 接受 一 个 实现 了 io .Reader 接口 类 型 的 值 
作为 参数 。 在 下 一 节 ， 我 们 会 更 详细 地 介绍 io .Reader 和 io.Writer 接口 ， 现 在 只 需要 知道 
标准 库 里 的 许多 不 同类 型 ， 包括 http 包 里 的 一 些 类 型 ， 都 实现 了 这 些 接口 就 行 。 只 要 类 型 实现 
了 这 些 接口 ， 就 可 以 自动 获得 许多 功能 的 支持 。 

函数 NewDecodez 返回 一 个 指向 Decoder 类 型 的 指针 值 。 由 于 Go 语言 支持 复合 语句 调用 ， 
































可 以 直接 调用 从 NewDecoder 函数 返回 的 值 的 Decode 方法 ， 而 不 用 把 这 个 返回 值 存 人 变量 。 
在 代码 清单 8-25 里 ， 可 以 看 到 Decoge 方法 接受 一 个 interface{} 类 型 的 值 做 参数 ， 并 返回 
一 个 error 值 。 

在 第 5 章 中 曾 讨 论 过 , 任何 类 型 都 实现 了 一 个 空 接口 interface{}。 这 意味 着 Decode 方 
法 可 以 接受 任意 类 型 的 值 ,使 用 反射 ,Decode 方法 会 拿 到 传人 值 的 类 型 信息 。 然 后 ,在 读 取 JSON 
响应 的 过 程 中 ,Decode 方法 会 将 对 应 的 响应 解码 为 这 个 类 型 的 值 。 这 意味 着 用 户 不 需要 创建 对 
应 的 值 ，Decoqde 会 为 用 户 做 这 件 事 情 ， 如 代码 清单 8-26 所 示 。 

在 代码 清单 8-26 中 , 我 们 向 Decode 方法 传人 了 指向 gResponse 类 型 的 指针 变量 的 地 址 ， 
而 这 个 地 址 的 实际 值 为 nil。 该 方法 调用 后 , 这 个 指针 变量 会 被 赋 给 一 个 gResponse 类 型 的 值 ， 
并 根据 解码 后 的 JSON 文档 做 初始 化 。 


代码 清单 8-26 ”使 用 Decode 方法 


Var gr *gResponse 
err = json.NewDecoder (resp.Body) .Decode (&gr) 


有 时 ， 需 要 处 理 的 JSON 文档 会 以 string 的 形式 存在 。 在 这 种 情况 下 ， 需 要 将 string 转换 
为 byte 切片 ( []byte )， 并 使 用 json 包 的 Unmarshal 因数 进行 反 序列 化 的 处 理 ， 如 代码 清单 
8-27 所 示 。 


代码 清单 8-27 listing27.go 


01 // 这 个 示例 程序 展示 如 何 解 码 JSON 字符 串 
02 package main 

















03 

04 import ( 

05 "encoding/json" 

06 VEmtE" 

07 TogY 

08 ) 

09 

10 // contact 结构 代表 我 们 的 JSoN 字符 串 

1 type Contact struct { 

2 Name string ‘json:"name". 
3 Title string ‘json:"title". 
14 Contact ‘stiyct...{ 

5 Home string “json:"home". 

6 Cell. string “Json"ceLll™: 
9 json Toontact 
8 让 
19 
20 // JSON 包含 用 于 反 序列 化 的 演示 字符 串 
21 var JSON = `{ 

2 "name": "Gopher", 
23 "title": "programmer", 
24 "contact se 渤 


25 "home™ M415533333335 


26 95595353 





23 } 

28. 0} 

29 

30 func main() { 

3 // 将 JSON 字符 串 反 序列 化 到 变量 

3 和 2 an :Contact 

33 err := json.Unmarshal([]byte(JSON), &c) 
34 if err != nil { 

35 log.Println ("ERROR:", err) 
36 return 

号 学 } 

38 

39 fmt .Println(c) 

40 } 


在 代码 清单 8-27 中 ， 我 们 的 例子 将 JSON 文档 保存 在 一 个 字符 串 变 量 里 ， 并 使 用 Unmarshal 于 
数 将 JSON 文档 解码 到 一 个 结构 类 型 的 值 里 。 如 果 运 行 这 个 程序 , 会 得 到 代码 清单 8-28 所 示 的 输出 。 


代码 清单 8-28 listing27.9o 的 输出 


{Gopher programmer {415.333.3333 415.555.5555}} 
有 时 , 无 法 为 JSON 的 格式 声明 一 个 结构 类 型 , 而 是 需要 更 加 灵活 的 方式 来 处 理 JSON 文档 。 
在 这 种 情况 下 ， 可 以 将 JSON 文档 解码 到 一 个 map 变量 中 ， 如 代码 清单 8-29 所 示 。 


代码 清单 8-29 listing29.go 


01 // 这 个 示例 程序 展示 如 何 解 码 JSON 字符 串 


02 package main 








03 

04 import (人 

05 "encoding/json" 

06 于 下 而 区 

07 WESGY 

08 ) 

09 

10 // JSON 包含 要 反 序列 化 的 样 例 字 符 串 

11 var JSON = { 

12 "name": "Gopher", 

13 "title": "programmer", 

14 "oontact™s, 

15 "home": "415.333.3333"， 
16 voelLl" /VAlS55855555" 

二 也 } 

18. 

19 

20 func main() { 

21 // 将 JSON 字符 串 反 序列 化 到 map 变量 
22 Var c map[lstring]interface{} 
23 err := json.Unmarshal([]byte(JSON), &c) 
24 if err != nil { 


25 log.Println ("ERROR:", err) 


26 return 


27 } 

28 

29 fmt.Println("Name:", c["name"]) 

30 fmt.Println("Title:", cl["title"]) 

3 六 fmt.Println("Contact") 

2 fmt.Println("H:", cl"contact"]. (map[string]interface{}) ["home"]) 
33 fmt.Println("C:", cl"contact"]. (map[string]interface{})["cell"]) 
34 } 


代码 清单 8-29 中 的 程序 修改 自 代 码 清单 8-27， 将 其 中 的 结构 类 型 变量 替换 为 map 类 型 的 变 
量 。 变 量 c 声明 为 一 个 map 类 型 ， 其 键 是 string 类 型 ， 其 值 是 interfacef{} 类 型 。 这 意味 
着 这 个 map 类 型 可 以 使 用 任意 类 型 的 值 作为 给 定 键 的 值 。 虽 然 这 种 方法 为 处 理 JSON 文档 带 来 
了 很 大 的 灵活 性 ， 但 是 却 有 一 个 小 缺点 。 让 我 们 看 一 下 访问 contact 子 文档 的 home 字段 的 代 
码 ， 如 代码 清单 8-30 所 示 。 








代码 清单 8-30 ”访问 解 组 后 的 映射 的 字段 的 代码 
fmt.Println("\tHome:", cl["contact"]. (map[string]interface{})["home"]) 
因为 每 个 键 的 值 的 类 型 都 是 interface{}， 所 以 必须 将 值 转换 为 合适 的 类 型 ,才能 处 理 这 
个 值 。 代 码 清单 8-30 展示 了 如 何 将 contact 键 的 值 转换 为 另 一 个 键 是 string 类 型 ， 值 是 
interface{} 类 型 的 map 类 型 。 这 有 时 会 使 映射 里 包含 另 一 个 文档 的 JSON 文档 处 理 起 来 不 那 

















么 友好 。 但 是 ， 如 果 不 需要 深入 正在 处 理 的 JSON 文档 , 或 者 只 打算 做 很 少 的 处 理 ， 因 为 不 需要 
声明 新 的 类 型 ,使 用 map 类 型 会 很 快 。 


8.3.2 编码 JSON 


我 们 要 学 习 的 处 理 JSON 的 第 二 个 方面 是 ,使 用 json 包 的 MarshalIndent 函数 进行 编码 。 
这 个 函数 可 以 很 方便 地 将 Go 语言 的 map 类 型 的 值 或 者 结构 类 型 的 值 转换 为 易 读 格式 的 JSON 文 
档 。 序 列 化 (marshal ) 是 指 将 数据 转换 为 JSON 字符 串 的 过 程 , 下 面 是 一 个 将 map 类 型 转换 为 JSON 
字符 串 的 例子 ， 如 代码 清单 8-31 所 示 。 


代码 清单 8-31 listing31.go 


01 // 这 个 示例 程序 展示 如 何 序列 化 JSON 字符 串 
02 Package main 





03 

04 import ( 

05 "encoding/json" 

06 Ent 

07 ToOgY” 

08 ) 

09 

10 func main() { 

11 // 创建 一 个 保存 键 值 对 的 映射 





2 c := make (map[lstring] interface{}) 
3 cl"name"] = "Gopher" 
14 c[l"title"] = "programmer" 
15: cl"contact"] = maplstring]interface{}{ 
6 "home: 4156333.3333™, 
7 
8 








1 TeellL ss M45..55505555% 

1 } 

19 

20 // 将 这 个 映射 序列 化 到 JSoN 字符 串 
21 data, err := json.MarshalInqdent (c, "", " | 
2 if err != nil { 

23 log.Println ("ERROR:", err) 
24 return 

25 } 

26 

237 fmt.Println(string(data)) 

28 } 


代码 清单 8-31 展示 了 如 何 使 用 json 包 的 MarshalIndent 函数 将 一 个 map 值 转换 为 JSON 
字符 串 。 函数 MarshalIndent 返回 一 个 byte 切片 , 用 来 保存 JSON 字符 串 和 一 个 error 值 。 
下 面 来 看 一 下 json 包 中 MarshalIndent 国 数 的 声明 ， 如 代码 清单 8-32 所 示 。 





代码 清单 8-32 golang.org/src/encoding/json/encode.go 
































// MarshalIndent 很 像 Marshal， 只 是 用 缩 进 对 输出 进行 格式 化 
func MarshalIndqent (v interface{}, Prefix indent string) ([]byte, error) { 


在 MarshalIndent 图 数 里 再 一 次 看 到 使 用 了 空 接口 类 型 interface{}。 阴 数 
MarshalIndent 会 使 用 反射 来 确定 如 何 将 map 类 型 转换 为 ON 字符 串 。 

如 果 不 需要 输出 带 有 缩 进 格式 的 JSON 字符 串 ，json 包 还 提供 了 名 为 Marshal 的 函数 来 进 
行 解码 。 这 个 函数 产生 的 JSON 字符 串 很 适合 作为 在 网 络 响应 ( 如 Web API ) 的 数据 。 函数 Marshal 
的 工作 原理 和 函数 MarshalInqdent 一 样 ,只 不 过 没有 用 于 前 缀 prefix 和 缩 进 indent 的 参数 。 





8.3.3 结论 


在 标准 库 里 都 已 经 提供 了 处 理 JSON 和 XML 格式 所 需要 的 诸如 解码 、 反 序列 化 以 及 序列 化 
数据 的 功能 。 随 着 每 次 Go 语言 新 版 本 的 发 布 ,这 些 包 的 执行 速度 也 越 来 越 快 ,这 些 包 是 处 理 JSON 
和 XML 的 最 佳 选择 。 由 于 有 反射 包 和 标签 的 支持 ， 可 以 很 方便 地 声明 一 个 结构 类 型 ， 并 将 其 中 
的 字段 映射 到 需要 处 理 和 发 布 的 文档 的 字段 。 由 于 json 包 和 xml 包 都 支持 io.Reader 和 
io.Writer 接口 ， 用 户 不 用 担心 自己 的 JSON 和 XML 文档 源 于 哪里 。 所 有 的 这 些 特性 都 让 处 
理 JSON 和 XML 变 得 很 容易 。 


Xs 输入 和 输出 


类 UNIX 的 操作 系统 如 此 伟大 的 一 个 原因 是 ,一 个 程序 的 输出 可 以 是 男 一 个 程序 的 输入 这 一 
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只 做 一 件 事 ， 并 把 这 
很 惊艳 的 事情 。 这 些 


品 


理念 。 依 照 这 个 哲学 ， 这 类 操作 系统 创建 了 一 系列 的 简单 程序 ， 每 个 程序 
事 做 得 非常 好 。 之 后 , 将 这 些 程序 组 合 在 一 起 ， 可 以 创建 一 些 脚本 做 一 些 
序 使 用 stdin 和 stdout 设备 作为 通道 ， 在 进程 之 间 传 递 数据 。 

同样 的 理念 扩展 到 了 标准 库 的 io 包 ， 而 且 提 供 的 功能 很 神奇 。 这 个 包 可 以 以 流 的 方式 高 效 
处 理 数据 ， 而 不 用 考虑 数据 是 什么 ， 数 据 来 自 哪里 ， 以 及 数据 要 发 送 到 哪里 的 问题 。 与 stdout 
和 stdin 对 应 ， 这 个 包含 有 io.Writer 和 io.Reader 两 个 接口 。 所 有 实现 了 这 两 个 接口 的 
类 型 的 值 ， 都 可 以 使 用 io 包 提 供 的 所 有 功能 ， 也 可 以 用 于 其 他 包 里 接受 这 两 个 接口 的 函数 以 及 
方法 。 这 是 用 接口 类 型 来 构造 函数 和 API 最 美妙 的 地 方 。 开发 人 员 可 以 基于 这 些 现 有 功能 进行 组 
合 ， 利 用 所 有 已 经 存在 的 实现 ， 专 注 于 解决 业务 问题 。 

有 了 这 个 概念 ， 让 我 们 先 看 一 下 io .wrtier 和 io.Reader 接口 的 声明 ,然后 再 来 分 析 展 
示 了 io 包 神 奇 功能 的 代码 。 


Es 




















8.4.1 Writer 和 Reader 接口 


io 包 是 围 线 着 实现 了 io.Writer 和 io.Reader 接口 类 型 的 值 而 构建 的 。 由 于 io .Write 
和 io.Reader 提供 了 足够 的 抽象 ， 这 些 io 包 里 的 函数 和 方法 并 不 知道 数据 的 类 型 ， 也 不 知道 
这 些 数据 在 物理 上 是 如 何 读 和 写 的 ,让 我 们 先 来 看 一 下 io .Write 接口 的 声明 ,如 代码 清单 8-33 
所 示 。 


代码 清单 8-33 io .Writer 接口 的 声明 


type Writer interface { 
Write(PD []byte) (n int err error) 
} 


代码 清单 8-33 展示 了 io .Writer 接口 的 声明 。 这 个 接口 声明 了 唯一 一 个 方法 Write， 这 
个 方法 接受 一 个 byte 切片 ， 并 返回 两 个 值 。 第 一 个 值 是 写 人 的 字 节 数 ， 第 二 个 值 是 error 错 
误 值 。 代 码 清单 8-34 给 出 的 是 实现 这 个 方法 的 一 些 规则 。 




















代码 清单 8-34 io .Write 接口 的 文档 
Write 从 p 里 向 底层 的 数据 流 写 入 len (p) 字 节 的 数据 。 这 个 方法 返回 从 p 里 写 出 的 字 闻 





















































数 (0 <= n <= len(p) ) ， 以 及 任何 可 能 导致 写 入 提前 结束 的 错误 。Write 在 返回 n 

< len (p) 的 时 候 ， 必 须 返 回 某 个 非 nil 值 的 error。Write 绝 不 能 改写 切片 里 的 数据 ， 

哪怕 是 临时 修改 也 不 行 。 

代码 清单 8-34 中 的 规则 来 自 标 准 库 。 这 些 规则 意味 着 Write 方法 的 实现 需要 试图 写 人 被 传 
人 的 byte 切片 里 的 所 有 数据 。 但 是 ， 如 果 无 法 全 部 写 人 ， 那 么 该 方法 就 一 定 会 返回 一 个 错误 。 
返回 的 写 入 字 节 数 可 能 会 小 于 byte 切片 的 长 度 , 但 不 会 出 现 大 于 的 情况 。 最 后 , 不 管 什 么 情况 ， 
都 不 能 修改 byte 切片 里 的 数据 。 

让 我 们 看 一 下 Reader 接口 的 声明 ， 如 代码 清单 8-35 所 示 。 






































代码 清单 8-35 io.Readez 接口 的 声明 


type Reader interface { 
Read(p []byte) (n int, err error) 
} 
代码 清单 8-35 中 的 io.Reader 接口 声明 了 一 个 方法 Read, 这 个 方法 接受 一 个 byte 切片 ， 
并 返回 两 个 值 。 第 一 个 值 是 读 和 的 字 节 数 ， 第 二 个 值 是 error 错误 值 。 代 码 清 单 8-36 给 出 的 是 


实现 这 个 方法 的 一 些 规则 。 


代码 清单 8-36 ”io .Reader 接口 的 文档 


(1) Read 最 多 读 入 len (p) 字 节 ， 保 存 到 pp。 这 个 方法 返回 读 入 的 字 节 数 (0 <= n 
<= len (p) ) 和 任何 读 取 时 发 生 的 错误 。 即 便 Read 返回 的 n < len (P) ， 方 法 也 可 
能 使 用 所 有 p 的 空间 存储 临时 数据 。 如 果 数 据 可 以 读 取 ， 但 是 字 节 长 度 不 足 len (p)， 
习惯 上 Read 会 立刻 返回 可 用 的 数据 ， 而 不 等 待 更 多 的 数据 。 










































































(2) 当成 功 读 取 n > 0 字 节 后 ， 如 果 遇 到 错误 或 者 文件 读 取 完 成 ，Read 方法 会 返回 

的 字 节 数 。 方 法 可 能 会 在 本 次 调用 返回 一 个 非 nil 的 错误 ， 或 者 在 下 一 次 调用 时 返 

( ) 。 这 种 情况 的 的 一 个 例子 是 ， 在 输入 的 流 结束 时 ，Read 会 返 区 

非 零 的 读 取 字 节 数 ， 可 能 会 返回 err == EOF， 也 可 能 会 返回 err == nil。 无论 如 何 ， 
下 一 次 调用 Read 应 该 返回 0，EOF。 





































































































j 者 在 返回 的 n > 0 时 ， 总 应 该 先 处 理 读 入 的 数据 ， 再 处 理 错误 err。 这 样 才 
能 正确 操作 读 取 一 部 分 字 节 后 发 生 的 I/0 错误 。EOF 也 要 这 样 处 理 。 




















(4) Read 的 实现 不 鼓励 返回 0 个 读 取 字 节 的 同时 ， 返 回 nil 值 的 错误 。 调 用 者 需要 将 

这 种 返回 状态 视 为 没有 做 任何 操作 ， 而 不 是 遇 到 读 取 结 束 。 

标准 库 里 列 出 了 实现 Read 方法 的 4 条 规则 。 第 一 条 规则 表明 ， 该 实现 需要 试图 读 取 数 据 来 
填 满 被 传人 的 byte 切片 。 允 许 出 现 读 取 的 字 节 数 小 于 pyte 切片 的 长 度 ， 并 且 如 果 在 读 取 时 已 
经 读 到 数据 但 是 数据 不 足以 填 满 byte 切片 时 ， 不 应 该 等 待 新 数据 ， 而 是 要 直接 返回 已 读数 据 。 

第 二 条 规则 提供 了 应 该 如 何 处 理 达 到 文件 末尾 (EOF ) 的 情况 的 指导 。 当 读 到 最 后 一 个 字 节 
时 ， 可 以 有 两 种 选择 。 一 种 是 Read 返回 最 终 读 到 的 字 节 数 ， 并 且 返 回 EOF 作为 错误 值 ， 男 一 
种 是 返回 最 终 读 到 的 字 节 数 ， 并 返回 nil 作为 错误 值 。 在 后 一 种 情况 下 ， 下 一 次 读 取 的 时 候 ， 
由 于 没有 更 多 的 数据 可 供 读 取 ， 需 要 返回 0 作为 读 到 的 字数 ， 以 及 EOF 作为 错误 值 。 

入 三 条 规则 是 给 调用 Read 的 人 的 建议 。 任 何 时 候 Read 返回 了 读 取 的 字 节 数 ， 都 应 该 优先 
处 理 这 些 读 取 到 的 字 节 ， 再 去 检查 EOF 错误 值 或 者 其 他 错误 值 。 最 终 ， 第 四 条 约束 建议 Read 
方法 的 实现 永远 不 要 返回 0 个 读 取 字 节 的 同时 返回 nil 作为 错误 值 。 如 果 没 有 读 到 值 ，Read 应 
该 总 是 返回 一 个 错误 。 

现在 知道 了 io.Writer 和 io.Reader 接口 是 什么 样子 的 ， 以 及 期 盼 的 行为 是 什么 ， 证 我 
们 看 一 下 如 何在 程序 里 使 用 这 些 接口 以 及 io 包 。 
































8.4.2 整合 并 完成 工作 
这 个 例子 展示 标准 库 里 不 同 包 是 如 何 通 过 支持 实现 了 io.Writer 接 口 类 型 的 值 来 一 起 完成 
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工作 的 。 这 个 示例 里 使 用 了 bytes 、fmt 和 os 包 来 进行 缓冲 、 拼 接 和 写字 符 串 到 stdout ， 如 
代码 清单 8-37 所 示 。 


代码 清单 8-37 listing37.go 


01 // 这 个 示例 程序 展示 来 自 不 同 标准 库 的 不 同 函数 是 如 何 
02 // 使 用 io.Writez 接口 的 


03 Package main 





























04 

05 import ( 

06 "bytes" 
07 TEmt"™ 
08 vos™ 

09 ) 




















1 // main 是 应 用 程序 的 入 
2 une maianty 

3 // 创建 一 个 Buffer 值 ， 并 将 一 个 字符 串 写 入 Buffer 
4 // 使 用 实现 io .Writer 的 Write 方法 

可 Var b bytes.Buffer 
6 

2 

8 





























b.write([]byte("Hello ")) 
































// 使 用 Fprintf 来 将 一 个 字符 串 拼 接 到 Buffer 里 
9 // 将 bytes .Buffer 的 地 址 作为 io.Writer 类 型 值 传 入 
20 fmt.Fprintf (&b, "World!™") 








22 // 将 Buffer 的 内 容 输 出 到 标准 输出 设备 
23 // 将 os.File 值 的 地 址 作为 io.Writer 类 型 值 传 入 
24 b.WriteTo (os.Stdout) 








运行 代码 清单 8-37 中 的 程序 会 得 到 代码 清单 8-38 所 示 的 输出 。 


Hello World! 
个 程序 使 用 了 标准 库 的 3 个 包 来 将 "Hello World!" 输 出 到 终端 窗口 。 一 开始 ， 程 序 在 
第 15 Se 了 一 个 pytes 包 里 的 Buffer 类 型 的 变量 ， 并 使 用 零 值 初始 化 。 在 第 16 行 创建 了 
一 个 pyte 切片 ， 并 用 字符 串 "Hel1lo" 初 始 化 了 这 个 切片 。byte 切片 随后 被 传人 Write 方法 ， 
成 为 Buffer 类 型 变量 里 的 初始 内 容 。 
第 20 行使 用 fmt 包 里 的 Fprintf 函数 将 字符 串 "Wwor1d!" 追 加 到 Buffer 类 型 变量 里 。 
让 我 们 看 一 下 Fprintf 函数 的 声明 ， 如 代码 清单 8-39 所 示 。 


代码 清单 8-39 golang.org/src/fmt/print.go 


// Fprintf 根据 格式 化 说 明 符 来 格式 写 入 内 容 ， 并 输出 到 w 
// 这 个 函数 返回 写 入 的 字 节 数 ， 以 及 任何 遇 到 的 错误 


func Fprintf(w io.Writer, format string, a ...interface{}) (n int, err error) 























8.4 输入 和 输出 197 


需要 注意 Fprintf 函数 的 第 一 个 参数 。 这 个 参数 需要 接收 一 个 实现 了 io .Writer 接口 类 
型 的 值 。 因 为 我 们 传人 了 之 前 创建 的 Buffer 类 型 值 的 地 址 ， 这 意味 着 bytes 包 里 的 Buffer 
类 型 必须 实现 了 这 个 接口 。 那 么 在 bytes 包 的 源 代码 里 ， 我 们 应 该 能 找到 为 Buffer 类 型 声明 
的 Write 方法， 如 代码 清单 8-40 所 示 。 


代码 清单 8-40 golang.org/src/bytes/buffer.go 


// Write 将 p 的 内 容 追 加 到 缓冲 区 ， 如 果 需 要 ， 会 增 大 缓冲 区 的 空间 。 返 回 值 n 是 
// Pp 的 长 度 ，err 总 是 nil。 如 果 缓 冲 区 变 得 太 大 ，Write 会 引起 裔 溃 .… 
func (b *Buffer) Write(p []pyte) (n int, err error) { 
b.lastRead = opInvalid 
m := b.grow (len (p)) 
return copy(b.buf[Im:], p), nil 
































} 

代码 清单 8-40 展示 了 Buffer 类 型 的 Write 方法 的 当前 版 本 的 实现 。 由 于 实现 了 这 个 方法 ， 
指向 Buffer 类 型 的 指针 就 满足 了 io.Writer 接口 ， 可 以 将 指针 作为 第 一 个 参数 传人 
Fprintf。 在 这 个 例子 里 ,我 们 使 用 Fprintf 函数 ， 最 终 通 过 Buffer 实现 的 Write 方法 ， 
将 "Worlgd! "字符 捉 追加 到 Buffer 类 型 变量 的 内 部 缓冲 区 。 

让 我 们 看 一 下 代码 清单 8-37 的 最 后 几 行 ， 如 代码 清单 8-41 所 示 ， 将 整个 Buffer 类 型 变量 
的 内 容 写 到 stdout。 














代码 清单 8-41 listing37.go: 第 22 行 到 第 25 行 








22 // 将 Buffer 的 内 容 输出 到 标准 输出 设备 

23 // 将 os.File 值 的 地 址 作为 io.Writer 类 型 值 传 入 
24 b.WriteTo (os.Stdout) 

Pa 


在 代码 清单 8-37 的 第 24 行 ,使 用 WriteTo 方法 将 Buffer 类 型 的 变量 的 内 容 写 到 stdout 
设备 。 这 个 方法 接受 一 个 实现 了 io.Writer 接口 的 值 。 在 这 个 程序 里 ， 传 人 的 值 是 os 包 的 
stdout 变量 的 值 ， 如 代码 清单 8-42 所 示 。 














代码 清单 8-42 golang.org/src/os/file.go 


bs a 
Stdin = NewFile(uintptr(syscall.Stdin), "/dev/stdin") 
Stdout = NewFile(uintptr (syscall.Stdout), "/dev/stdout") 
Stderr = NewFile (uintptr(syscall.Stderr), "/dev/stderr") 
) 


这 些 变量 自动 声明 为 NewFile 函数 返回 的 类 型 ， 如 代码 清单 8-43 所 示 。 





代码 清单 8-43 golang.org/src/os/file_unix.go 
// NewFile 返回 一 个 具有 给 定 的 文件 描述 符 和 名 字 的 新 File 


func NewFile(fd uintptr, name string) *File { 
fdi := int (fd) 
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i :Ed < ‘0 寺 
return nil 


} 


f := &File{&file{fd: fdi, name: name}} 
runtime.SetrFinalizer(f.file, (*file).close) 
return f 


} 

就 像 在 代码 清单 8-43 里 看 到 的 那样 ，NewFile 函数 返回 一 个 指向 File 类 型 的 指针 。 这 就 
是 Stdout 变量 的 类 型 。 既 然 我 们 可 以 将 这 个 类 型 的 指针 作为 参数 传人 WriteTo 方法 ,那么 这 
个 类 型 一 定 实 现 了 io .Writet 接口。 在 os 包 的 源 代码 里 , 我 们 应 该 能 找到 Write 方法 , 如 代 
码 清单 8-44 所 示 。 


代码 清单 8-44 golang.org/src/os/file.go 


// Write 将 len (b) 个 字 节 写 入 File 
// 这 个 方法 返回 写 入 的 字 节 数 ， 如 果 有 错误 ， 也 会 返回 错误 
// 如 果 n != len (b)，Write 会 返回 一 个 非 nil 的 错误 
func (f *File) Write(b []byte) (n int, err error) { 
if f == nil { 
return 0, Errinvalid 























nr e := f.write (b) 
的 证 
n= 0 
if n != len(b) { 
err = io.ErrShortWrite 





epipecheck (f, e) 
if e != nil { 
err = &PathError{"write", f.name, el 
} 
return n, err 


} 
没 错 , 代码 清单 8-44 中 的 代码 展示 了 File 类 型 指针 实现 io .Writer 接口 类 型 的 代码 。 让 
我 们 再 看 一 下 代码 清单 8-37 的 第 24 行 ， 如 代码 清单 8-45 所 示 。 





代码 清单 8-45 listing37.go: 第 22 行 到 第 25 行 





22 // 将 Buffer 的 内 容 输出 到 标准 输出 设备 
23 // 将 os.File 值 的 地 址 作为 io.Writer 类 型 值 传 入 
24 b.WriteTo (os.Stdout) 





可 以 看 到 ，WriteTo 方法 可 以 将 Buffer 类 型 变量 的 内 容 写 到 stdout ， 结 果 就 是 在 终端 
窗口 上 显示 了 "Hello World!" 字 符 串 。 这 个 方法 会 通过 接口 值 , 调用 File 类 型 实现 的 Write 
方法 。 


这 个 例子 展示 了 接口 的 优雅 以 及 它 带 给 语言 的 强大 的 能 力 。 得 益 于 bytes .Buffer 和 
os .File 类 型 都 实现 了 Writer 接口 ， 我 们 可 以 使 用 标准 库 里 已 有 的 功能 ， 将 这 些 类 型 组 合 在 
一 起 完成 工作 。 接 下 来 让 我 们 看 一 个 更 加 实用 的 例子 。 


8.4.3 简单 的 curl 


在 Linux 和 MacOS ( 曾 用 名 Mac OS X ) 系统 里 可 以 找到 一 个 名 为 curl 的 命令 行 工具 。 这 
个 工具 可 以 对 指定 的 URL 发 起 HTTP 请 求 ， 并 保存 返回 的 内 容 。 通 过 使 用 http、io 和 os 包 ， 
我 们 可 以 用 很 少 的 几 行 代码 来 实现 一 个 自己 的 curl 工具 。 

让 我 们 来 看 一 下 实现 了 基础 cuzl 功能 的 例子 ， 如 代码 清单 8-46 所 示 。 


代码 清单 8-46 listing46.go 
01 // 这 个 示例 程序 展示 如 何 使 用 io.Reader 和 io.Writer 接 
02 // 写 一 个 简单 版 本 的 curl 
03 Package main 

































































04 
05 import (人 
06 oA 
07 的 芭 eKe 
08 "net/http" 
09 vos 
10 ) 
2 // main 是 应 用 程序 的 入 
3 func main() { 
14 // 这 里 的 r+ 是 一 个 响应 ，r .Body 是 io.Reader 
15 r, err := http.Get (os.Args [1]) 
6 if err != nil { 
ya log.Fatalln (err) 
18 } 
19 
20 // 创建 文件 来 保存 响应 内 容 
21 file, err := os.Create(os.Args[2]) 
22 if err != nil { 
23 log.Fatalln (err) 
24 } 
25 defer file.Close() 
26 














27 // 使 用 MultiWriter， 这 样 就 可 以 同时 向 文件 和 标准 输出 设备 
28 // 进行 写 操作 























29 dest := io.MultiWriter(os.Stdout, file) 
30 

3 // 读 出 响应 的 内 容 ， 并 写 到 两 个 目的 地 

2 io.Copy (dest, r.Body) 

区 if err := r.Body.Close(); err != nil { 
34 log.Println (err) 

35 } 
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代码 清单 8-46 展示 了 一 个 实现 了 基本 骨架 功能 的 cur1， 它 可 以 下 载 、 展 示 并 保存 任意 的 
HTTP Get 请 求 的 内 容 。 这 个 例子 会 将 响应 的 结果 同时 写 人 文件 以 及 stdout。 为 了 让 例子 保持 
简单 ， 这 个 程序 没有 检查 命令 行 输入 参数 的 有 效 性 ， 也 没有 支持 更 高 级 的 选项 。 

在 这 个 程序 的 第 15 行 ， 使 用 来 自命 令 行 的 第 一 个 参数 来 执行 HTTP Get 请 求 。 如 果 这 个 参 
数 是 一 个 URL， 而 且 请 求 没 有 发 生 错误 ， 变 量 + 里 就 包含 了 该 请 求 的 响应 结果 。 在 第 21 行 , 我 
们 使 用 命令 行 的 第 二 个 参数 打开 了 一 个 文件 。 如 果 这 个 文件 打开 成 功 ， 那 么 在 第 25 行 会 使 用 
defer 语句 安排 在 函数 退出 时 执行 文件 的 关闭 操作 。 

因为 我 们 希望 同时 向 stdqout 和 指定 的 文件 里 写 请 求 的 内 容 ， 所 以 在 第 29 行 我 们 使 用 io 
包 里 的 Multiwriter 困 数 将 文件 和 stdout 整合 为 一 个 io.Writer 值 。 在 第 33 行 ， 我 们 使 
用 io 包 的 Copy 函数 从 响应 的 结果 里 读 取 内 容 ， 并 写 入 两 个 目的 地 。 由 于 有 MultiWriter 函 
数 提供 的 值 的 支持 ， 我 们 可 使 用 一 次 Copy 调用 ,将 内 容 同时 写 到 两 个 目的 地 。 

利用 io 包 里 已 经 提供 的 支持 ,以 及 http 和 os 包 里 已 经 实现 了 io.Writer 和 io.Reader 
接口 类 型 的 实现 , 我们 不 需要 编写 任何 代码 来 完成 这 些 底层 的 函数 , 借助 已 经 存在 的 功能 , 将 注 
意 力 集中 在 需要 解决 的 问题 上 。 如 果 我 们 自己 的 类 型 也 实现 了 这 些 接口 ,就 可 以 立刻 支持 已 有 的 
大 量 功 能 。 


















































8.4.4 结论 


可 以 在 io 包 里 找到 大 量 的 支持 不 同 功 能 的 函数 ， 这 些 函 数 都 能 通过 实现 了 io.Writer 和 
io.Reader 接口 类 型 的 值 进行 调用 。 其 他 包 ， 如 http 包 ， 也 使 用 类 似 的 模式 ， 将 接口 声明 为 
包 的 API 的 一 部 分 ， 并 提供 对 io 包 的 支持 。 应 该 花 时 间 看 一 下 标准 库 中 提供 了 些 什么 ,以 及 它 
是 如 何 实现 的 一 一 不 仅 要 防止 重新 造 轮子 ， 还 要 理解 Go 语言 的 设计 者 的 习惯 ， 并 将 这 些 习惯 应 
用 到 自己 的 包 和 API 的 设计 上 。 

















8.5 小结 


标准 库 有 特殊 的 保证 ， 并 且 被 社区 广泛 应 用 。 

使 用 标准 库 的 包 会 让 你 的 代码 更 易于 管理 ， 别 人 也 会 更 信任 你 的 代码 。 
100 余 个 包 被 合理 组 织 ， 分 布 在 38 个 类 别 里 。 

标准 库 里 的 1og 包 拥 有 记录 日 志 所 需 的 一 切 功 能 。 

标准 库 里 的 xml 和 json 包 让 处 理 这 两 种 数据 格式 变 得 很 简单 。 

io 包 支 持 以 流 的 方式 高 效 处 理 数据 。 

接口 允许 你 的 代码 组 合 已 有 的 功能 。 

阅读 标准 库 的 代码 是 熟悉 Go 语言 习惯 的 好 方法 。 


























第 9 章 测试 和 性 能 





本 章 主要 内 容 

编写 单元 测试 来 验证 代码 的 正确 性 

使 用 httptest 来 模拟 基于 HTTP 的 请 求 和 响应 
使 用 示例 代码 来 给 包 写 文档 

通过 基准 测试 来 检查 性 能 














作为 一 名 合格 的 开发 者 ,不 应 该 在 程序 开发 完 之 后 才 开 始 写 测试 代码 。 使 用 Go 语言 的 测试 
框架 ,可 以 在 开发 的 过 程 中 就 进行 单元 测试 和 基准 测试 。 和 go build 命令 类 似 ，go test 命 
令 可 以 用 来 执行 写 好 的 测试 代码 , 需要 做 的 就 是 遵守 一 些 规则 来 写 测试 。 而且, 可 以 将 测试 无 缝 
地 集成 到 代码 工程 和 持续 集成 系统 里 。 




















4ss 单元 测试 
单元 测试 是 用 来 测试 包 或 者 程序 的 一 部 分 代码 或 者 一 组 代码 的 函数 ,测试 的 目的 是 确认 目标 





























代码 在 给 定 的 场景 下 ,有 没有 按照 期 望 工作 。 一 个 场景 是 正 向 路 经 测试 ， 就 是 在 正常 执行 的 情况 
下 ,保证 代码 不 产生 错误 的 测试 。 这 种 测试 可 以 用 来 确认 代码 可 以 成 功 地 向 数据 库 中 搬入 一 条 工 
作 记 录 。 














另外 一 些 单元 测试 可 能 会 测试 负 向 路 径 的 场景 ,保证 代码 不 仅 会 产生 错误 ,而且 是 预期 的 错 
误 。 这 种 场景 下 的 测试 可 能 是 对 数据 库 进 行 查询 时 没有 找到 任何 结果 , 或 者 对 数据 库 做 了 无 效 的 
更 新 。 在 这 两 种 情况 下 ,测试 都 要 验证 确实 产生 了 错误 ， 且 产生 的 是 预期 的 错误 。 总 之 ,不 管 如 
何 调用 或 者 执行 代码 ， 所 写 的 代码 行为 都 是 可 预期 的 。 

在 Go 语言 里 有 几 种 方法 写 单元 测试 。 基 础 测试 (basic test ) 只 使 用 一 组 参数 和 结果 来 测试 
一 段 代码 。 表 组 测试 (table test ) 也 会 测试 一 段 代码 ， 但 是 会 使 用 多 组 参数 和 结果 进行 测试 。 也 
可 以 使 用 一 些 方法 来 模仿 (mock ) 测试 代码 需要 使 用 到 的 外 部 资源 ， 如 数据 库 或 者 网 络 服务 器 。 
这 有 助 于 让 测试 在 没有 所 需 的 外 部 资源 可 用 的 时 候 ， 模 拟 这 些 资 源 的 行为 使 测试 正常 进行 。 最 后 ， 



























































在 构建 自己 的 网 络 服务 时 ， 有 了 几 种 方法 可 以 在 不 运行 服务 的 情况 下 ， 调 用 服务 的 功能 进行 测试 。 
9.1.1 基础 单元 测试 
让 我 们 看 一 个 单元 测试 的 例子 ， 如 代码 清单 9-1 所 示 。 
代码 清单 9-1 listing01_test.go 


01 // 这 个 示例 程序 展示 如 何 写 基础 单元 测试 
02 Package listing01 























03 

04 import ( 

Us "net/http" 

06 "testing" 

07 ) 

08 

09 const checkMark = "\u2713" 

10 const ballotX = "\u2717" 

2 // TestDownload 确认 http 包 的 Get 函数 可 以 下 载 内 容 

3 func TestDownload(t *testing.T) { 

14 url := "http://www.goinggo.net/feeds/posts/default?alt=rss" 
15 statusCode := 200 

6 

7 t.Log("Given the need to test downloading content.") 

18 { 

19 t.Logf("\tWwhen checking \"%s\" for status code \"%sd\"", 
20 url, statusCode) 
疙 4 { 
22 resp, err := http.Get (url) 
23 if err != nil { 
24 t.Fatal("\t\tShould be able to make the Get call.", 
25 ballotXx, err) 
26 } 
27 t.Log("\t\tShould be able to make the Get call.", 
28 checkMark) 
29 

30 defer resp.Body.Close() 

31 
32 if resp.StatusCode == statusCode { 

33 t.Logf("\t\tShould receive a \"%d\" status. gv", 
34 statusCode, checkMark) 
35 } else { 
36 t.Errorf("\t\tShould receive a \"%d\" status. gv gsVny 
337 statusCode, ballotX, resp.StatusCode) 
38 } 
39 } 
40 } 
41 } 


代码 清单 9-1 展示 了 测试 http 包 的 Get 函数 的 单元 测试 ,测试 的 内 容 是 确保 可 以 从 网 络 正 
常 下 载 goinggo.net 的 RSS 列表 。 如 果 通 过 调用 go test -v 来 运行 这 个 测试 ( -v 表示 提供 元 


余 输出 )， 会 得 到 图 9-1 所 示 的 测试 结果 。 


wnloading content . 
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图 9-1 基础 单元 测试 的 输出 








这 个 例子 背后 发 生 了 很 多 事情 , 来 确保 测试 能 正确 工作 , 并 显示 结果 。 让 我 们 从 测试 文件 的 
文件 名 开始 。 如果 查 看 代码 清单 9-1 一 开始 的 部 分 , 会 看 到 测试 文件 的 文件 名 是 listing01_test.go。 
Go 语言 的 测试 工具 只 会 认为 以 _test.go 结尾 的 文件 是 测试 文件 。 如 果 没 有 遵从 这 个 约定 ,在 包 里 
运行 go test 的 时 候 就 可 能 会 报告 没有 测试 文件 。 一 旦 测试 工具 找到 了 测试 文件 ， 就 会 查找 里 
面 的 测试 函数 并 执行 。 

让 我 们 仔细 看 看 listing01_test.go 测试 文件 里 面 的 代码 ， 如 代码 清单 9-2 所 示 。 





代码 清单 9-2 listing01_test.go: 第 01 行 到 第 10 行 


01 // 这 个 示例 程序 展示 如 何 写 基础 单元 测试 
02 package listing01 




















03 

04 import ( 

05 "net/http" 

06 "testing" 

07 ) 

08 

09 const checkMark = "\u2713" 
10 const ballotX = "\u2717" 


在 代码 清单 9-2 里 ， 可 以 看 到 第 06 行 引 入 了 testing 包 。 这 个 testing 包 提供 了 从 测试 
框架 到 报告 测试 的 输出 和 状态 的 各 种 测试 功能 的 支持 。 第 09 行 和 第 10 行 声明 了 两 个 常量 , 这 两 
个 常量 包含 写 测试 输出 时 会 用 到 的 对 号 (NY) 和 又 号 ( x )。 

接 下 来 ， 让 我 们 看 一 下 测试 函数 的 声明 ， 如 代码 清单 9-3 所 示 。 








代码 清单 9-3 listing01 test.go: 第 12 行 到 第 13 行 


12 // TestDownload 确认 http 包 的 Get 函数 可 以 下 载 内 容 
13 func TestDownload(t *testing.T) { 





在 代码 清单 9-3 的 第 13 行 中 ,可 以 看 到 测试 函数 的 名 字 是 TestDownload。 一 个 测试 函数 
必须 是 公开 的 函数 ,并且 以 Test 单词 开头 。 不 但 函数 名 字 要 以 Test 开头 ， 而 且 函 数 的 签名 必 
须 接收 一 个 指向 testing.T 类 型 的 指针 ,并 且 不 返回 任何 值 。 如 果 没 有 遵守 这 些 约定 ,测试 框 
架 就 不 会 认为 这 个 函数 是 一 个 测试 函数 ， 也 不 会 让 测试 工具 去 执行 它 。 

指向 testing.T 类 型 的 指针 很 重要 。 这 个 指针 提供 的 机 制 可 以 报告 每 个 测试 的 输出 和 状态 。 























测试 的 输出 格式 没有 标准 要 求 。 我 更 喜欢 使 用 Go 写 文档 的 方式 ， 输 出 容易 读 的 测试 结果 。 对 我 
来 说 ,测试 的 输出 是 代码 文档 的 一 部 分 。 测 试 的 输出 需 使 用 完整 易 读 的 语句 , 来 记录 为 什么 需要 
这 个 测试 ， 具 体 测 试 了 什么 ， 以 及 测试 的 结果 是 什么 。 让 我 们 来 看 一 下 更 多 的 代码 ， 了 解 我 是 如 
何 完成 这 些 测试 的 ， 如 代码 清单 9-4 所 示 。 








代码 清单 9-4 listing01 test.go: 第 14 行 到 第 18 行 


14 url := "http://www.goinggo.net/feeds/posts/default?alt=rss" 
15 statusCode := 200 

16 

17 t.Log("Given the need to test downloading content.") 

18 { 


可 以 看 到 ， 在 代码 清单 9-4 的 第 14 行 和 第 15 行 ， 声明 并 初始 化 了 两 个 变量 。 这 两 个 变量 包 
含 了 要 测试 的 URL， 以 及 期 望 从 响应 中 返回 的 状态 。 在 第 17 行 ， 使 用 方法 t .Log 来 输出 测试 
的 消息 。 这 个 方法 还 有 一 个 名 为 t .Logf 的 版 本 ， 可 以 格式 化 消息 。 如 果 执行 go test 的 时 候 
没有 加 入 宛 余 选项 〈-v )， 除 非 测 试 失败 ， 和 否则 我 们 是 看 不 到 任何 测试 输出 的 。 

每 个 测试 函数 都 应 该 通过 解释 这 个 测试 的 给 定 要 求 ( given need ), 来 说 明 为 什么 应 该 存在 这 
个 测试 。 对 这 个 例子 来 说 ,给 定 要 求 是 测试 能 否 成 功 下 载 数 据 。 在 声明 了 测试 的 给 定 要 求 后 , 测 
试 应 该 说 明 被 测试 的 代码 应 该 在 什么 情况 下 被 执行 ， 以 及 如 何 执 行 。 




















代码 清单 9-5 ”listing01_test.go: 第 19 行 到 第 21 行 


149 t.Logf("\tWhen checking \"%s\" for status code \"%d\"", 
20 url, statusCode) 
21 { 





可 以 在 代码 清单 9-5 的 第 19 行 看 到 测试 执行 条 件 的 说 明 。 它 特别 说 明了 要 测试 的 值 。 接 下 
来 ， 让 我 们 看 一 下 被 测试 的 代码 是 如 何 使 用 这 些 值 来 进行 测试 的 。 





22 resp, err := http.Get (url) 

23 if err != nil { 

24 t.Fatal("\t\tShould be able to make the Get call.", 
5 ballotXx, err) 

26 } 

27 t.Log("\t\tShould be able to make the Get call.", 

28 checkMark) 

29 

30 defer resp.Body.Close() 


代码 清单 9-6 中 的 代码 使 用 http 包 的 Get 函数 来 向 goinggo.net 网 络 服务 器 发 起 请 求 ， 请 
求 下 载 该 博客 的 RSS 列表 。 在 Get 调用 返回 之 后 ， 会 检查 错误 值 ， 来 判断 调用 是 否 成 功 。 在 每 
种 情况 下 ,我们 都 会 说 明 测试 应 有 的 结果 。 如 果 调 用 失败 ,除了 结果 , 还 会 输出 又 号 以 及 得 到 的 
错误 值 。 如 果 测 试 成 功 ， 会 输出 对 号 。 








如 果 Get 调用 失败 ,使 用 第 24 行 的 t .Fatal 方法 ,让 测试 框架 知道 这 个 测试 失败 了 。 
t.Fatal 方法 不 但 报告 这 个 单元 测试 已 经 失败 ， 而 且 会 向 测试 输出 写 一 些 消息 ， 而 后 立刻 停止 
这 个 测试 函数 的 执行 。 如 有 果 除 了 这 个 函数 外 还 有 其 他 没有 执行 的 测试 函数 , 会 继续 执行 其 他 测试 
函数 。 这 个 方法 对 应 的 格式 化 版 本 名 为 上 .Fatalf。 

如 果 需 要 报告 测试 失败 , 但 是 并 不 想 停止 当前 测试 函数 的 执行 ， 可 以 使 用 t .Error 系列 方 
法 ， 如 代码 清单 9-7 所 示 。 

















代码 清单 9-7 listing01_test.go: 第 32 行 到 第 41 行 





32 if resp.StatusCode == statusCode { 

33 t.Logf("\t\tShould receive a \"%d\" status. %v", 

34 statusCode, checkMark) 

35 } else { 

36 t.Errorf("\t\tShould receive a \"%d\" status. gv gsVny 
3 statusCode, ballotX, resp.StatusCode) 

38 } 

9 } 

40 } 

41 } 


在 代码 清单 9-7 的 第 32 行 ， 会 将 响应 返回 的 状态 码 和 我 们 期 望 收 到 的 状态 码 进行 比较 。 我 
们 再 次 声明 了 期 望 测试 返回 的 结果 是 什么 。 如 果 状 态 码 匹配 ,我 们 就 使 用 t .Logf 方法 输出 信息 ; 
否则 ， 就 使 用 t .Errorf 方法 。 因 为 t .Errorf 方法 不 会 停止 当前 测试 函数 的 执行 ， 所以， 如 
果 在 第 38 行 之 后 还 有 测试 ,单元 测试 就 会 继续 执行 。 如 果 测 试 函 数 执行 时 没有 调用 过 七 .Fatal 
或 者 t .Error 方法 ， 就 会 认为 测试 通过 了 。 

如 果 再 看 一 下 测试 的 输出 ( 如 图 9-2 所 示 )， 你 会 看 到 这 段 代 码 组 合 在 一 起 的 效果 。 
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图 9-2 基础 单元 测试 的 输出 











在 图 9-2 中 能 看 到 这 个 测试 的 完整 文档 。 下 载 给 定 的 内 容 ， 当 检测 获取 URL 的 内 容 返回 的 
状态 码 时 (在 图 中 被 截断 )， 我 们 应 该 能 够 成 功 完成 这 个 调用 并 收 到 状态 200。 测 试 的 输出 很 清 
晰 ， 能 描述 测试 的 目的 ,同时 包含 了 足够 的 信息 。 我 们 知道 具体 是 哪个 单元 测试 被 运行 ,测试 通 
过 了 ， 并 且 运 行 消耗 的 时 间 是 435 毫秒 。 




















9.1.2” 表 组 测试 
如 果 测 试 可 以 接受 一 组 不 同 的 输入 并 产生 不 同 的 输出 的 代码 , 那么 应 该 使 用 表 组 测试 的 方法 





进行 测试 。 表 组 测试 除了 会 有 一 组 不 同 的 输入 值 和 期 望 结 果 之 外 ， 其 余部 分 都 很 像 基础 单元 测试 。 
测试 会 依次 迭代 不 同 的 值 ， 来 运行 要 测试 的 代码 。 每 次 迭代 的 时 候 ， 都 会 检测 返回 的 结果 。 这 便 
于 在 一 个 函数 里 测试 不 同 的 输入 值 和 条 件 。 让 我 们 看 一 个 表 组 测试 的 例子 , 如 代码 清单 9-8 所 示 。 


代码 清单 9-8 listing08_test.go 


01 // 这 个 示例 程序 展示 如 何 写 一 个 基本 的 表 组 测试 
02 package listing08 





























03 
04 import ( 
Us "net/http" 
06 "testing" 
07 ) 
08 
09 const checkMark = "\u2713" 
10 const ballotX = "\u2717" 
2 // TestDownload 确认 http 包 的 Get 函数 可 以 下 载 内 容 
3 // 并 正确 处 理 不 同 的 状态 
14 func TestDownload(t *testing.T) { 
15 Var urls = []struct { 
6 url string 
3 statusCode int 
18 }1{ 
19 { 
2.0 "http://www.goinggo.net/feeds/posts/default?alt=rss", 
21 httPp .StatusOK， 
之 2 Fs 
23 { 
24 "http://rss.cnn.com/rss/cnn topstbadurl.rss", 
25 http.StatusNotFoung, 
26 }, 
2 } 
28 
29 t.Log("Given the need to test downloading different content.") 
30 { 
二 for , u := range urls { 
32 t.Logf("\tWwhen checking \"%s\" for status code \"%sd\"", 
33 u.url, u.statusCode) 
34 { 
35 resp, err := http.Get (u.url) 
36 if err != nil { 
7 t.Fatal("\t\tShould be able to Get the url.", 
38 ballotXx, err) 
39 } 
40 t.Log("\t\tShould be able to Get the url", 
41 checkMark) 
42 
43 defer resp.Body.Close() 
44 
45 if resp.StatusCode == u.statusCode { 


46 t.Logf("\t\tShould have a \"%d\" status. gv", 


47 
48 
49 
50 
51 
52 
53 
54 
55 } 


u.statusCode, checkMark) 
} else { 
t.Errorf("\t\tShould have a \"%d\" status %v gv", 
u.statusCode, ballotX, resp.StatusCode) 


在 代码 清单 9-8 中 ， 我 们 稍微 改动 了 之 前 的 基础 单元 测试 ， 将 其 变 为 表 组 测试 。 现 在 ， 可 以 








使 用 一 个 测试 函数 来 测试 不 同 的 URL 以 及 http.Get 方法 的 返回 状态 码 。 我 们 不 需要 为 每 个 要 
测试 的 URL 和 状态 码 创建 一 个 新 测试 函数 。 让 我 们 看 一 下 ， 和 之 前 相 比 ， 做 了 哪些 改动 ， 如 代 


码 清单 9-9 所 示 。 


代码 清单 9-9 


listing08_test.go: 第 12 行 到 第 27 行 





12 // TestDownload 确认 http 包 的 Get 函数 可 以 下 载 内 容 
13 // 并 正确 处 理 不 同 的 状态 








14 func TestDownload(t *testing.T) { 

1 Var urls = []struct { 

16 url string 

下 池 statusCode int 

18 } 

L9 { 

20 "http://www.goinggo.net/feeds/posts/default?alt=rss", 
21 http.StatusoR, 

吃 2 kr 

23 { 

24 "http://rss.cnn.com/rss/cnn topstbadurl.rss", 
25 http.StatusNotFoung, 

26 }, 

27 } 


在 代码 清单 9-9 中 ， 可 以 看 到 和 之 前 同名 的 测试 函数 TestDownload， 它 接收 一 个 指向 


testing.T 





类 型 的 指针 。 但 这 个 版 本 的 TestDownload 略微 有 些 不 同 。 在 第 15 行 到 第 27 行 ， 


可 以 看 到 表 组 的 实现 代码 。 表 组 的 第 一 个 字段 是 URL， 指 向 一 个 给 定 的 互联 网 资源 ， 第 二 个 字 








段 是 我 们 广 


青 求 资 


源 后 期 望 收 到 的 状态 码 


目前 ， 我 们 的 表 组 只 :配置 了 两 组 值 。 第 一 组 信 征 goinggo.net 的 URL， 响 应 状态 为 OK， 第 
二 组 值 是 另 一 个 URL， 响 应 状态 为 NotFound。 运 行 这 个 测试 会 得 到 图 9-3 所 示 的 输出 。 





$ go test -V 
== RUN TestDowntLoad 


‘should be 十 


Should have 
When checking "ht 
Should be ab 
Should have a "484" status, v 
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9-3” 表 组 测试 的 输出 





时 











图 9-3 所 示 的 输出 展示 了 如 何 迭 代表 组 里 的 值 ， 并 使 用 其 进行 测试 。 输出 看 起 来 和 基础 单元 
测试 的 输出 很 像 ， 只 是 每 次 都 会 输出 两 个 不 同 的 URL 及 其 结果 。 测 试 又 通过 了 。 
让 我 们 看 一 下 我 们 是 如 何 让 表 组 测试 工作 的 ， 如 代码 清单 9-10 所 示 。 


代码 清单 9-10 ”listing08_test.go: 第 29 行 到 第 34 行 





29 t.Log("Given the need to test downloading different content.") 
30 { 

沪 直 for , u := range urls { 

32 t.Logf("\tWwhen checking \"%s\" for status code \"%sd\"", 
33 u.url, u.statusCode) 

34 { 


代码 清单 9-10 的 第 31 行 的 for range 循环 让 测 | 试 选 ee 使 用 不 同 的 URL 运 
行 测试 代码 。 测 试 的 代码 与 基础 单元 测试 的 代码 相同 , 只 不 过 这 次 使 用 的 是 表 组 内 的 值 进 行 测试 
如 代码 清单 9-11 所 示 。 


代码 清单 9-11 listing08 testgo: 第 35 行 到 第 55 行 





hs resp, err := http.Get (u.url) 

36 if err != nil { 

3 t.Fatal("\t\tShould be able to Get the url.", 
38 ballotXx, err) 

39 } 

40 t.Log("\t\tShould be able to Get the url", 

41 checkMark) 

42 

43 defer resp.Body.Close() 

44 

45 if resp.StatusCode == u.statusCode { 

46 t.Logf("\t\tShould have a \"%d\" status. gv", 
47 u.statusCode, checkMark) 

48 } else { 

49 t.Errorf("\t\tShould have a \"%d\" status %v gv", 
50 u.statusCode, ballotxX, resp.StatusCode) 
51 } 

52 } 

53 } 

54 } 

55: .1 


代码 清单 9-11 的 第 35 行 中 展示 了 代码 如 何 使 用 u .url 字段 来 做 URL 调用 ,在 第 45 行 中 ， 
u.statusCode 字段 被 用 于 和 实际 的 响应 状态 码 进行 比较 。 如 果 以 后 需要 扩展 测试 ， 只 需要 将 
新 的 URL 和 状态 码 加 入 表 组 就 可 以 ， 不 需要 改动 测试 的 核心 代码 。 
9.1.3 ”模仿 调用 


我 们 之 前 写 的 单元 测试 都 很 好 , 但 是 还 有 些 瑕 羔 。 首 先 , 这 些 测试 需要 访问 互联 网 , 才能 





证 测试 运行 成 功 。 图 9-4 展示 了 如 果 没 有 互联 网 连接 ， 运 行 基础 单元 测试 会 测试 失败 。 


ggo.net/feeds/posts 
ke the Get call. X Get 
: lookup ww.goinggo. 





he om/goinaction/code/chapte Listing91 





时 


9-4 由 于 没有 互联 网 连接 导致 测试 失败 











不 能 总 是 假设 运行 测试 的 机 器 可 以 访问 互联 网 。 此 外 , 依赖 不 属于 你 的 或 者 你 无 法 操作 的 服 
务 来 进行 测试 , 也 不 是 一 个 好 习惯 。 这 两 点 会 严重 影响 测试 持续 集成 和 部 署 的 自动 化 。 如 果 突 然 
断 网 ， 导 致 测试 失败 ， 就 没 办 法 部 署 新 构建 的 程序 。 

为 了 修正 这 个 问题 ， 标 准 库 包含 一 个 名 为 httptest 的 包 ， 它 让 开发 人 员 可 以 模仿 基于 
HTTP 的 网 络 调用 。 模 仿 ( mocking ) 是 一 个 很 常用 的 技术 手段 ， 用 来 在 运行 测试 时 模拟 访问 不 
可 用 的 资源 。 包 httptest 可 以 让 你 能 够 模仿 互联 网 资源 的 请 求 和 响应 。 在 我 们 的 单元 测试 中 ， 
通过 模仿 http .Get 的 响应 , 我 们 可 以 解决 在 图 9-4 中 遇 到 的 问题 , 保证 在 没有 网 络 的 时 候 , 我 
们 的 测试 也 不 会 失败 ， 依 旧 可 以 验证 我 们 的 http.Get 调用 正常 工作 ， 并 且 可 以 处 理 预期 的 响 
应 。 让 我 们 看 一 下 基础 单元 测试 ， 并 将 其 改 为 模仿 调用 goinggo.net 网 站 的 RSS 列表 ， 如 代码 清 
单 9-12 所 示 。 








































































































代码 清单 9-12 ”listing12_test.go: 第 01 行 到 第 41 行 























01 // 这 个 示例 程序 展示 如 何 内 部 模仿 HTTP GET 调用 
02 // 与 本 书 之 前 的 例子 有 些 差 别 
03 Package listingl2 

















04 

05 import (人 

06 "encoding/xml" 

07 Tm 

08 "met /http™ 

09 "net/http/httptest" 

10 "testing" 

a 

12 

13 const checkMark = "\u2713" 

14 const balloeotX 二 "Nu2717Y 

15 

16 // feed 模仿 了 我 们 期 望 接收 的 XML 文档 

17 var feedq = `<?xml version="1.0" encoding="UTF-8"?> 
18 <rss> 

19 <channel> 

20 <title>Going Go Programming</title> 

21 <description>Golang : https://github.com/goinggo</description> 


22 <link>http://www.goinggo.net/</link> 


23 <item> 


24 <pubDate>sun, 15 Mar 2015 15:04:00 +0000</pubDate> 

25 <title>Object Oriented Programming Mechanics</title> 

26 <description>Go is an object oriented language.</description> 
27 <link>http://www.goinggo.net/2015/03/o0bject-oriented</link> 
28 </item> 


29 </channel> 

30 </zSS>” 

31 

32 // mockServer 返回 用 来 处 理 请 求 的 服务 器 的 指针 


33 func mockServer() *httptest.Server { 




















et 








34 f := func(w http.ResponseWriter, r *http.Request) { 
35 w.WriteHeader (200) 

36 w.Header() .Set ("Content-Type", "application/xml") 
37 fmt.Fprintln(w, feed) 

38 } 

39 

40 return httptest.NewServer (http.HandlerFunc (f)) 

41 } 


代码 清单 9-12 展示 了 如 何 模 仿 对 goinggo.net 网 站 的 调用 ， 来 模拟 下 载 RSS 列表 。 在 第 17 
行 中 ,声明 了 包 级 变量 feed， 并 初始 化 为 模仿 服务 器 返回 的 RSS XML 文档 的 字符 串 。 这 是 实 
际 RSS 文档 的 一 小 段 , 足以 完成 我 们 的 测试 。 在 第 33 行 中 , 我 们 声明 了 一 个 名 为 mockServer 
的 函数 ， 这 个 函数 利用 httptest 包 内 的 支持 来 模拟 对 互联 网 上 真实 服务 器 的 调用 ， 如 代码 清 
单 9-13 所 示 。 


代码 清单 9-13 ”listing12_test.go: 第 32 行 到 第 41 行 














32 // mockServer 返回 用 来 处 理 调用 的 服务 器 的 指针 


33 func mockServer() *httptest.Server { 











34 f := func(w http.ResponseWriter, r *http.Request) { 
35 w.WriteHeader (200) 

36 w.Header() .Set ("Content-Type", "application/xml") 
可 了 fmt .FEPrintln(w feed) 

38 } 

39 

40 return httptest.NewServer (http.HandlerFunc (f)) 

41 } 


代码 清单 9-13 中 声明 的 mockServer 水 数 ， 返 回 一 个 指向 httptest .Server 类 型 的 指 
针 。 这 个 httptest .Server 的 值 是 整个 模仿 服务 的 关键 。 函 数 的 代码 一 开始 声明 了 一 个 匿名 
函数 ， 其 签名 符合 http .HandlerFunc 函数 类 型 ， 如 代码 清单 9-14 所 示 。 





代码 清单 9-14 golang.org/pkg/net/http/#HandlerF unc 


type HandlerFunc func(ResponseWriter, *Request) 

















Ni 





HandlerFunc 类 型 是 一 个 适配器 ， 人 允许 常规 函数 作为 HTTP 的 处 理 函 数 使 用 。 如 果 函 数 £ 
HandlerFunc (f£) 就 是 一 个 处 理 HTTP 请 求 的 Handler 对 象 ， 内 部 通过 调用 上 处 理 请 求 


遵守 这 个 签名 ， 让 匿名 函数 成 了 处 理 函 数 。 一 旦 声明 了 这 个 处 理 函 数 ， 第 40 行 就 会 使 用 这 


有 合适 的 签名 ， 
































个 匿名 函数 作为 参数 来 调用 httptest .NewServer 函数 ， 创 建 我 们 的 模仿 服务 器 。 之 后 在 第 
40 行 ， 通 过 指针 返回 这 个 模仿 服务 器 。 

我 们 可 以 通过 http .Get 调用 来 使 用 这 个 模仿 服务 器 ， 用 来 模拟 对 goinggo.net 网 络 服务 器 
的 请 求 。 当 进行 http.Get 调用 时 ,实际 执行 的 是 处 理 函 数 ， 并 用 处 理 函 数 模 仿 对 网 络 服务 器 
的 请 求 和 响应 。 在 第 35 行 ， 处理 函 数 首 先 设置 状态 码 ， 之 后 在 第 36 行 , 设置 返回 内 容 的 类 型 
Content-Type， 最 后 ， 在 第 37 行使 用 包含 XML 内 容 的 字符 串 feed 作为 响应 数据 ， 返 回 
给 调用 者 。 

现在 ， 让 我 们 看 一 下 模仿 服务 器 与 基础 单元 测试 是 怎么 整合 在 一 起 的 ， 以 及 如 何 将 
http .Get 请 求 发 送 到 模仿 服务 器 ， 如 代码 清单 9-15 所 示 。 








代码 清单 9-15 listing12_test.go: 第 43 行 到 第 74 行 
43 // TestDownload 确认 http 包 的 Get 函数 可 以 下 载 内 容 








44 // 并 且 内 容 可 以 被 正确 地 反 序列 化 并 关闭 


45 func TestDownload(t *testing.T) { 




















46 statusCode := httP.StatusOK 

47 

48 server := mockServer() 

49 defer server.Close() 

50 

51 t.Log("Given the need to test downloading content.") 

52 { 

53 t.Logf("\tWhen checking \"%s\" for status code \"%sd\"", 
54 Server.URL, statusCode) 

53 { 

56 resp, err := http.Get (server.URL) 

St if err != nil { 

58 t.Fatal("\t\tShould be able to make the Get call.", 
59 ballotXx, err) 

60 } 

61 t.Log("\t\tShould be able to make the Get call.", 
62 checkMark) 

63 

64 defer resp.Body.Close() 

65 

66 if resp.StatusCode != statusCode { 

67 t.Fatalf("\t\tShould receive a \"%d\" status. %v gsVny 
68 statusCode, ballotX, resp.StatusCode) 

69 } 

70 t.Logf("\t\tShould receive a \"%d\" status. %v", 

汪 于 statusCode, checkMark) 

72 } 

73 } 

74 } 


在 代码 清单 9-15 中 再 次 看 到 了 TestDownload 函数 , 不 过 这 次 它 在 请 求 模仿 服务 器 。 在 第 
48 行 和 第 49 行 ， 调用 mockServer 函数 生成 模仿 服务 器 ， 并 安排 在 测试 函数 返回 时 执行 服务 
顺 的 Close 方法。 之 后 ， 除 了 代码 清单 9-16 所 示 的 这 一 行 代码 ， 这 段 测试 代码 看 上 去 和 基础 单 


元 测试 的 代码 一 模 一 样 。 


代码 清单 9-16 listing12_testgo: 第 56 行 


56 resp, err := http.Get (server.URL) 





这 次 由 httptest .Server 值 提 供 了 请 求 的 URL。 当 我 们 使 用 由 模仿 服务 器 提供 的 URL 
时 , http.Get 调用 依旧 会 按 我 们 预期 的 方式 运行 。 http.Get 方法 调用 时 并 不 知道 我 们 的 调用 
是 否 经 过 互联 网 。 这 次 调用 最 终 会 执行 , 并 且 我 们 自己 的 处 理 函 数 最 终 被 执行 , 返回 我 们 预先 准 
备 好 的 XML 文档 和 状态 码 http .StatusOK。 

在 图 9-5 里 ， 如 果 在 没有 互联 网 连接 的 时 候 运 行 测试 ， 可 以 看 到 测试 依旧 可 以 运行 并 通过 。 
这 张 图 展示 了 程序 是 如 何 再 次 通过 测试 的 。 如 果 仔细 看 用 于 调用 的 URL， 会 发 现 这 个 URL 使 用 
了 localhost 作为 地 址 ， 端 口 是 52065。 这 个 端口 号 每 次 运行 测试 时 都 会 改变 。 包 http 与 包 
httptest 和 模仿 服务 器 结合 在 一 起 ， 知 道 如 何 通过 URL 路 由 到 我 们 自己 的 处 理 函 数 。 现 在 ， 
我 们 可 以 在 没有 触 碰 实际 服务 器 的 情况 下 ， 测 试 请 求 goinggo.net 的 RSS 列表 。 












































e/ chapter 867s 


9-5 没有 互联 网 接 入 情况 下 测试 成 功 





网 | 











9.1.4 测试 服务 端点 


服务 端点 〈endpoint ) 是 指 与 服务 宿主 信息 无 关 ， 用 来 分 辨 某 个 服务 的 地 址 ， 一 般 是 不 包含 
宿主 的 一 个 路 径 。 如 果 在 构造 网 络 API， 你 会 希望 直接 测试 自己 的 服务 的 所 有 服务 端点 ， 而 不 用 
启动 整个 网 络 服务 。 包 httptest 正好 提供 了 做 到 这 一 点 的 机 制 。 让 我 们 看 一 个 简单 的 包含 一 
个 服务 端点 的 网 络 服务 的 例子 ， 如 代码 清单 9-17 所 示 ， 之 后 你 会 看 到 如 何 写 一 个 单元 测试 , 来 
模仿 真正 的 调用 。 











代码 清单 9-17 listing17.go 


01 // 这 个 示例 程序 实现 了 简单 的 网 络 服务 
02 package main 








03 

04 import ( 

05 "1ogn 

06 "net/http" 

07 

08 "github.com/goinaction/code/chapter9/listingl7/handlers" 
09 ) 














11 // main 是 应 用 程序 的 入 














12 func main() { 

过 handlers.Routes () 

14 

ES log.Println("listener : Started : Listening on :4000") 
16 http.ListenAndServe(":4000", nil) 

小生 


代码 清单 9-17 展示 的 代码 文件 是 整个 网 络 服务 的 入 口 。 在 第 13 行 的 main 函数 里 ,代码 调 
用 了 内 部 handlers 包 的 Routes 函数 。 这 个 函数 为 托管 的 网 络 服务 设置 了 一 个 服务 端点 。 在 
main 函数 的 第 15 行 和 第 16 行 ,显示 服务 监听 的 端口 ， 并 且 启 动 网 络 服务 ， 等 待 请 求 。 
现在 让 我 们 来 看 一 下 handlers 包 的 代码 ， 如 代码 清单 9-18 所 示 。 


代码 清单 9-18 handlers/handlers.go 


01 // handlers 包 提 供 了 用 于 网 络 服务 的 服务 端点 
02 package handlers 





























03 

04 import ( 

05 "encoding/json" 
06 "net/http" 

07 ) 

08 


09 // Routes 为 网 络 服务 设置 路 


CY 


func Routes () 
} 


1 
3 

14 // SendJSON 返 

15 func SendJSON 
6 
a 
8 





http.Handl 





























{ 
leFunc("/sendjson", SendJSON) 





回 一 个 简单 的 JSON 文档 
(rw http.ResponseWriter, r *http.Request) { 








Ur = StrUCt 
Name string 
Email string 
9 }{ 

20 Name: "Bill", 
21 Email: "billQ@ardanstudios.com", 
22 } 
23 
24 rw.Header() .Set ("Content-Type", "application/json") 
25 rw.WriteHeader (200) 
26 json.NewEncoder (rw) .Encode (&u) 
27. 3} 


代码 清单 9-18 里 展示 了 handlers 包 的 代码 。 这 个 包 提供 了 实现 好 的 处 理 函 数 ， 并 且 能 ; 
网 络 服务 设置 路 由 。 在 第 10 行 ,你 能 看 到 Routes 了 数 ,使 用 http 包 里 默认 的 http.ServeMux 





来 配置 路 由 , 将 URL 


映射 到 对 应 的 处 理 代 码 。 在 第 11 行 , 我 们 将 /senqjson 服务 端点 与 


SenqdJSON 函数 绑 定 在 一 起 。 
从 第 15 行 起 ， 是 SendJSON 函数 的 实现 。 这 个 函数 的 签名 和 之 前 看 到 代码 清单 9-14 里 


http.HandlerFunc 


函数 类 型 的 签名 一 致 。 在 第 16 行 ， 声明 了 一 个 匿名 结构 类 型 ， 使 用 这 个 


结构 创建 了 一 个 名 为 的 变量 , 并 赋予 一 组 初 值 。 在 第 24 行 和 第 25 行 , 设置 了 响应 的 内 容 类 型 





和 状态 码 。 最 后 ， 在 第 26 行 ,将 u 值 编 码 为 JSON 文档 ， 并 发 送 回 发 起 调用 的 客户 端 。 
如 果 我 们 构建 了 一 个 网 络 服务 ， 并 启动 服务 器 ， 就 可 以 像 图 9-6 和 图 9-7 展示 的 那样 ， 通 过 
服务 获取 JSON 文档 。 





所 已 localhost:4000/sendjson 





{"Name":"Bill","Email":"bill@ardanstudios .com"} 


图 9-6 ”启动 网 络 服 务 图 9-7 ”网络 服务 提供 的 J] SON 文档 


现在 有 了 包含 一 个 服务 端点 的 可 用 的 网 络 服 务 ， 我 们 可 以 写 单元 测试 来 测试 这 个 服务 端点 ， 
如 代码 清单 9-19 所 示 。 








代码 清单 9-19 handlers/handlers_test.go 


01 // 这 个 示例 程序 展示 如 何 测试 内 部 服务 端点 
02 // 的 执行 效果 
03 package handlers test 








04 
05 import (人 
06 "encoding/json" 
07 "net/http" 
08 "net/http/httptest" 
09 "testing" 
10 
T "github.com/goinaction/code/chapter9/listingl7/handlers" 
2 
3 
14 const checkMark = "\u2713" 
15 const ballotX = "\u2717" 
6 
了 fune init() 1 
18 handlers.Routes () 
19: 3 
20 


21 // TestSenqdJSON 测试 /sendjson 内 部 服务 端点 
22 func TestSendJSON(t *testing.T) { 


23 t.Log("Given the need to test the SendJSON endpoint.") 
24 { 

25 req, err := http.NewRequest ("GET", "/sendjson", nil) 
26 if err != nil { 

27 t.Fatal("\tShould be able to create a request.", 
28 ballotX, err) 

29 } 

30 t.Log("\tShould be able to create a request.", 

31 checkMark) 

32 

33 rw := httptest.NewRecorder () 

34 http.DefaultServeMux.ServeHTTP (rw, redq) 

35 

36 if rw.Code != 200 { 


37 t.Fatal("\tShould receive \"200\"", ballotx, rw.Code) 


38 } 





39 t.Log("\tShould receive \"200\"", checkMark) 

40 

41 u := struct { 

42 Name string 

43 Email string 

44 }{} 

45 

46 if err := json.NewDecoder (rw.Body) .Decode(&u); err != nil { 
47 t.Fatal("\tShould decode the response.", ballotx) 
48 } 

49 t.Log("\tShould decode the response.", checkMark) 

50 

2 if u.Name == "Bill" { 

S52 t.Log("\tShould have a Name.", checkMark) 

53 } -else { 

54 t.Error("\tShould have a Name.", ballotX, u.Name) 
55 } 

56 

57 if u.Email == "billQ@ardanstudios.com" { 

58 t.Log("\tShould have an Email.", checkMark) 

59 } Else- 

60 t.Error("\tShould have an Email.", ballotXx, u.Email) 
61 } 

62 } 

63. 7 


代码 清单 9-19 展示 了 对 /senqjson 服务 端点 的 单元 测试 。 注 意 , 第 03 行 包 的 名 字 和 其 他 
测试 代码 的 包 的 名 字 不 太一 样 ， 如 代码 清单 9-20 所 示 。 


代码 清单 9-20 handlers/handlers_test.go: 第 01 行 到 第 03 行 








01 // 这 个 示例 程序 展示 如 何 测 试 内 部 服务 端点 

02 // 的 执行 效果 

03 Package handlers test 

正如 在 代码 清单 9-20 里 看 到 的 ， 这 次 包 的 名 字 也 使 用 _test 结尾 。 如 果 包 使 用 这 种 方式 命 
名 , 测试 代码 只 能 访问 包 里 公开 的 标识 符 。 即 便 测 斌 代码 文件 和 被 测试 的 代码 放 在 同一 个 文件 夹 
中 ， 也 只 能 访问 公开 的 标识 符 。 

就 像 直 接 运 行 服务 时 一 样 ， 需 要 为 服务 端点 初始 化 路 由 ， 如 代码 清单 9-21 所 示 。 


代码 清单 9-21 handlezs/handlers_testgo: 第 17 行 到 第 19 行 





于 天 二 世人 (人 
18 handlers.Routes () 
2 中 


在 代码 清单 9-21 的 第 17 行 ， 声明 的 init 函数 里 对 路 由 进行 初始 化 。 如 果 没 有 在 单元 测试 
运行 之 前 初始 化 路 由 , 那么 测试 就 会 遇 到 http .StatusNotFound 错误 而 失败 。 现 在 让 我 们 看 
一 下 /sendjson 服务 端点 的 单元 测试 ， 如 代码 清单 9-22 所 示 。 





代码 清单 9-22 handlers/handlers_test.go: 第 21 行 到 第 34 行 


21 // TestSendJSON 测试 /sendjson 内 部 服务 端点 
22 func TestSendJSON(t *testing.T) { 


23 t.Log("Given the need to test the SendJSON endpoint.") 
24 { 

25 req, err := http.NewRequest ("GET", "/sendjson", nil) 
26 if err != nil { 

终了 t.Fatal("\tShould be able to create a request.", 
28 ballotXx, err) 

29 } 

30 t.Log("\tShould be able to create a request.", 

二 二 checkMark) 

32 

33 rw := httptest.NewRecorder () 

34 http.DefaultServeMux.ServeHTTP (rw, req) 


代码 清单 9-22 展示 了 测试 函数 TestSendJSON 的 声明 。 测 试 从 记录 测试 的 给 定 要 求 开 始 ， 
然后 在 第 25 行 创建 了 一 个 http.Request 值 。 这 个 Request 值 使 用 GET 方法 调用 /sendjson 
服务 端点 的 响应 。 由 于 这 个 调用 使 用 的 是 GET 方法 ， 第 三 个 发 送 数据 的 参数 被 传人 nil。 

之 后 , 在 第 33 行 , 调用 httptest .NewRecoder 函数 来 创建 一 个 http .ResponseRecorder 
值 。 有 了 http.Request 和 http.ResponseRecoder 这 两 个 值 ， 就 可 以 在 第 34 行 直 接 调用 
服务 默认 的 多 路 选择 器 ( mux ) 的 ServeHttp 方法 。 调 用 这 个 方法 模仿 了 外 部 客户 端 对 
/sendjson 服务 端点 的 请 求 。 

一 日 ServeHTTP 方法 调用 完成 , http.ResponseRecorder 值 就 包含 了 SendJSON 处 理 
函数 的 响应 。 现 在 ， 我 们 可 以 检查 这 个 响应 的 内 容 ， 如 代码 清单 9-23 所 示 。 


代码 清单 9-23 handlers/handlers_test.go: 第 36 行 到 第 39 行 





36 if rw.Code != 200 { 

33 t.Fatal("\tShould receive \"200\"", ballotx, rw.Code) 
38 } 

39 t.Log("\tShould receive \"200\"", checkMark) 


首先 ,在 第 36 行 检查 了 响应 的 状态 。 一 般 任何 服务 端点 成 功 调用 后 ， 都 会 期 望 得 到 200 的 
状态 码 。 如 果 状 态 码 是 200， 之 后 将 JSON 响应 解码 成 Go 的 值 。 





代码 清单 9-24 handlers/handlers_test.go: 第 41 行 到 第 49 行 


41 u := struct { 

42 Name string 

43 Email string 

44 }{} 

45 

46 if err := json.NewDecoder (rw.Body) .Decode(&u); err != nil { 
47 t.Fatal("\tShould decode the response.", ballotx) 

48 } 

49 t.Log("\tShould decode the response.", checkMark)” 


在 代码 清单 9-24 的 第 41 行 ,声明 了 一 个 匿名 结构 类 型 ,使 用 这 个 类 型 创建 了 名 为 u 的 变量 ， 


并 初始 化 为 零 值 。 在 第 46 行 ， 使 用 json 包 将 响应 的 JSON 文档 解码 到 变量 u 里 。 如 果 解 码 失 
败 ， 单 元 测试 结束 ; 否则 ， 我 们 会 验证 解码 后 的 值 是 否 正 确 ， 如 代码 清单 9-25 所 示 。 





代码 清单 9-25 ”handlers/handlers_test.go: 第 51 行 到 第 63 行 


5 if u.Name == "Bil1l" { 

5 t.Log("\tShould have a Name.", checkMark) 

53 } else { 

54 t.Error("\tShould have a Name.", ballotX, u.Name) 
55 } 

56 

SS if u.Email == "bill@ardanstudios.com" { 

58 t.Log("\tShould have an Email.", checkMark) 

59 } else { 

60 t.Error("\tShould have an Email.", ballotX, u.Email) 
61 J 

62 } 

63. } 


代码 清单 9-25 展示 了 对 收 到 的 两 个 值 的 检测 。 在 第 51 行 ， 我 们 检测 Name 字段 的 值 是 否 为 
"Bill"， 之 后 在 第 57 行 ， 检 查 Email 字段 的 值 是 否 为 "bill@ardanstudios.com"。 如 果 
这 些 值 都 匹配 ， 单 元 测试 通过 ; 否则 ,单元 测试 失败 。 这 两 个 检测 使 用 Erro 方法 来 报告 失败 ， 
所 以 不 管 检测 结果 如 何 ， 两 个 字段 都 会 被 检测 。 


Se 示例 


Go 语言 很 重视 给 代码 编写 合适 的 文档 。 专门 内 置 了 godoc 工具 来 从 代码 直接 生成 文档 。 在 
第 3 华中 ， 我们 已 经 学 过 如 何 使 用 godoc 工具 来 生成 包 的 文档 。 这 个 工具 的 男 一 个 特性 是 示例 
代码 。 示 例 代 码 给 文档 和 测试 都 增加 了 一 个 可 以 扩展 的 维度 。 

如 果 使 用 浏览 器 来 浏览 json 包 的 Go 文档 ， 会 看 到 类 似 图 9-8 所 示 的 文档 。 








< > golang.org/pkg/encoding/json/ 


type UnsupportedValueError 
func (e "UnsupportedValueError) Error() string 


Examples 


Decoder 
Indent 
Marshal 
RawMessage 
Unmarshal 


Package files 





decode.go encode.go fold.go indent.go scanner.go stream.go tags.go 
图 9-8 包 json 的 示例 代码 列表 
包 json 含有 5 个 示例 , 这 些 示例 都 会 在 这 个 包 的 Go 文档 里 有 展示 。 如 果 选 中 第 一 个 示例 ， 





会 看 到 一 段 示 例 代 码 ， 如 图 9-9 所 示 。 


所 C golang.org/pkg/encoding/json/#example_Decoder 9 
v Example 


This example uses a Decoder to decode a stream of distinct JSON values. 





package main 


import ( 
"encoding/json" 
nfmt" 


nio" 
nlog" 
"strings”" 
) 


func main() { 
const jsonStream =“ 
"Name": "Ed", "Text":; "Knock knock."} 
1 "Sam", "Text": "Who's there?"} 
: “Ed", “Text": "Go fat."} 
1 "Sam", "Text": "Go fmt who?"} 
{"Name":; "Ed", "Text"; "Go fmt yourself!"} 


type Message struct { 
Name, Text string 


} 
deo 全 json.NewDecoder(strings.NewReader(jsonStream)) 
or 


var m Message 
if err := dec.Decode(&m); err == i0.EOF { 
k 


real 
} else if err != nil { 
log.Fatal(err) 


fmt.Printf("%s: %s\n", m.Name, m,.Text) 











图 9-9 Go 文档 里 显示 的 Decoder 示例 视图 


开发 人 员 可 以 创建 自己 的 示例 ， 并 且 在 包 的 Go 文档 里 展示 。 让 我 们 看 一 个 来 自前 一 节 例 子 
的 SendJSON 函数 的 示例 ， 如 代码 清单 9-26 所 示 。 





代码 清单 9-26 handlers_example testgo 

















01 // 这 个 示例 程序 展示 如 何 编写 基础 示例 
02 package handlers test 


03 

04 import (人 

05 "encoding/json" 

06 hy 

07 "log" 

08 "net/http" 

09 "net/http/httptest" 
10 ) 

汪汪 

















12 // ExampleSendJSON 提供 了 基础 示例 

13 func ExampleSendJSON() { 

14 rr _ := http.NewRequest ("GET", "/sendjson", nil) 
工 3 rw := httptest.NewRecorder () 

16 http.DefaultServeMux.ServeHTTP (rw, L) 




















18 Var u ‘struct { 

19 Name string 

20 Email string 

21 } 

22 

23 if err := json.NewDecoder (WwW.Bodqy) .Decode(&u); err != nil { 
24 log.Println ("ERROR:", err) 

25 } 

26 

27 // 使 用 fmt 将 结果 写 到 st dout 来 检测 输出 
28 fmt .Println (u) 

29 // Output: 

30 // {Bill billQ@ardanstudios.com} 
3 








示例 基于 已 经 存在 的 函数 或 者 方法 ,我 们 需要 使 用 Example 代替 Test 作为 函数 名 的 开始 。 
在 代码 清单 9-26 的 第 13 行 中 ， 示 例 代 码 的 名 字 是 ExampleSendJSON。 

对 于 示例 代码 , 需要 遵守 一 个 规则 。 示例 代码 的 函数 名 字 必 须 基于 已 经 存在 的 公开 的 函数 或 
者 方法 。 我 们 的 示例 的 名 字 基 于 nandlers 包 里 公开 的 SendJSON 函数 。 如 果 没 有 使 用 已 经 存 
在 的 函数 或 者 方法 ， 这 个 示例 就 不 会 显示 在 包 的 Go 文档 里 。 

写 示例 代码 的 目的 是 展示 某 个 函数 或 者 方法 的 特定 使 用 方法 。 为 了 判断 测试 是 成 功 还 是 失 
败 ， 需 要 将 程序 最 终 的 输出 和 示例 函数 底部 列 出 的 输出 做 比较 ， 如 代码 清单 9-27 所 示 。 























代码 清单 9-27 handlers_example_ testgo: 第 27 行 到 第 31 行 























27 // 使 用 fmt 将 结果 写 到 stdout 来 检测 输出 
28 fmt .Println (u) 

29 // Output: 

30 // {Bill billQ@ardanstudios.com} 

二 十 


在 代码 清单 9-27 的 第 28 行 , 代码 使 用 fmt .Println 输出 变量 u 的 值 到 标准 输出 。 变 量 u 
的 值 在 调用 /sendjson 服务 端点 之 前 使 用 零 值 初始 化 。 在 第 29 行 中 ， 有 一 段 带 有 output :的 

这 个 output :标记 用 来 在 文档 中 标记 出 示例 函数 运行 后 期 望 的 输出 。Go 的 测试 框架 知道 如 
何 比较 注释 里 的 期 望 输出 和 标准 输出 的 最 终 输 出 。 如 果 两 者 匹配 ， 这 个 示例 作为 测试 就 会 通过 ， 
并 加 入 到 包 的 Go 文档 里 。 如 果 输 出 不 匹配 ， 这 个 示例 作为 测试 就 会 失败 。 

如 果 启 动 一 个 本 地 的 godoc 服务 器 (godoc -http=":3000" )， 并 找到 handlers 包 ， 
就 能 看 到 包含 示例 的 文档 ， 如 图 9-10 所 示 。 

在 图 9-10 里 可 以 看 到 handlers 包 的 文档 里 展示 了 SenqJSoN 也 数 的 示例 。 如 果 选 中 这 个 
SendJSoON 链接 ， 文 档 就 会 展示 这 上 段 代码 ， 如 图 9-11 所 示 。 

图 9-11 展示 了 示例 的 一 组 完整 文档 ， 包 括 代码 和 期 望 的 输出 。 由 于 这 个 示例 也 是 测试 的 一 
部 分 ， 可 以 使 用 go test 工具 来 运行 这 个 示例 函数 ， 如 图 9-12 所 示 。 









































func SendJSON 
func Send]SON(rw http.Responsewriter, r *http.Request) 


SendJSON returns a simple JSON document. 
v Example 


ExampleSendJSON provides a basic example test example. 


Code: 
r，_ := http.NewRequest("GET", "/sendjson", nil) 
Overview ~ w := httptest.NewRecorder() 
http.DefaultServeMux.ServeHTTP(w, r) 
Package handlers provides the endpoints for the web service. var U struct { 
Name string 
Index ~ Email string 
func Routes() if err := json.NewDecoder(w.Body).Decode(&u); err != nil { 
func SendJSON(rw http. ResponseWriter, + “http.Request) log.Printin("ERROR:", err) 
Examples 
fmt.Println(u) 
SendJSON 


Package files 


handlers.90 





图 9-10 handlers 包 的 godoc 视 医 


Output: 


{Bill bill@ardanstudios. com} 








光 
网 | 














9-11 在 godoc 里 显示 完整 的 示例 代码 








$ go test -Vv -run="ExampleSendJSON" 
=== RUN: | 


-~--~ PASS: ExampleSendJSON (6.66s) 
PASS 


ok github.com/goinaction/code/chapter9/listingi7/handlers 06.8688s 


图 9-12 ”运行 示例 代码 








运行 测试 后 ， 可 以 看 到 测试 通过 了 。 这 次 运行 测试 时 ,使 用 -run 选项 指定 了 特定 的 函数 














ExampleSendJSON。-run 选项 接受 任意 的 正则 表达 式 ， 来 过 滤 要 运行 的 测试 函数 。 这 个 选项 
既 支 持 单元 测试 ， 也 支持 示例 函数 。 如 果 示 例 运行 失败 ， 输 出 会 与 图 9-13 所 示 的 样子 类 似 。 








$ go test -v -run="ExampLeSendJSON" 
=== RUN: ExampLeSendJSON 

--- FAIL: ExampLeSendJSON (6.096s) 
got: 

{Lisa LisaGgmaiL.com} 


want: 

{Bill bille@ardanstudios .com} 

FAIL 

exit status 1 

FAIL github.com/goinaction/code/chapter9/Listing1l7/handlers 0.696s 





图 9-13 ”示例 运行 失败 

















如 果 示 例 运行 失败 ，go test 会 同时 展示 出 生成 的 输出 ， 以 及 期 望 的 输出 。 


SS 基准 测试 

















基准 测试 是 一 种 测试 代码 性 能 的 方法 。 想 要 测试 解决 同一 问题 的 不 同方 案 的 性 能 , 以 及 查看 





哪 种 解决 方案 的 性 能 更 好 时 ， 基 准 测试 就 会 很 有 用 。 基 准 测试 也 可 以 用 来 识别 某 段 代码 的 CPU 


或 者 内 存 效率 问题 , 而 这 段 代码 的 效率 可 能 会 严重 影响 整个 应 用 程序 的 性 能 。 许多 开发 人 员 会 用 
基准 测试 来 测试 不 同 的 并 发 模式 , 或 者 用 基准 测试 来 辅助 配置 工作 池 的 数量 ,以 保证 能 最 大 化 系 
统 的 吞 叶 量 。 

让 我 们 看 一 组 基准 测试 的 函数 ,， 找 出 将 整数 值 转 为 字符 串 的 最 快 方法 。 在 标准 库 里 ,有 3 种 
方法 可 以 将 一 个 整数 值 转 为 字符 串 。 

代码 清单 9-28 展示 了 listing28_test.go 基准 测试 开始 的 几 行 代码 。 





代码 清单 9-28 listing28_testgo: 第 01 行 到 第 10 行 


























01 // 用 来 检测 要 将 整数 值 转 为 字符 串 ， 使 用 哪个 函数 会 更 好 的 基准 
02 // 测试 示例 。 先 使 用 fmt .Sprintf 函数 ， 人 然后 使 用 
03 // strconv.FormatInt 函数 ， 最 后 使 用 strconv.Itoa 
04 package listing28 test 
































05 

06 import ( 

07 ”fn ™ 

08 Vstrcony" 
09 "testing" 
10 ) 


和 单元 测试 文件 一 样 ， 基 准 测 试 的 文件 名 也 必须 以 _test .go 结尾 。 同 时 也 必须 导入 
testing 包 。 接 下 来 ， 让 我 们 看 一 下 其 中 一 个 基准 测试 函数 ， 如 代码 清单 9-29 所 示 。 





代码 清单 9-29 ”listing28_test.go: 第 12 行 到 第 22 行 


12 // BenchmarkSprintf 对 fmt .Sprintf 函数 
13 // 进行 基准 测试 
14 func BenchmarkSprintf(b *testing.B) { 





Es number := 10 

16 

7 b.ResetTimer () 

18 

19 for i := 0; i < b.N; i++ { 

20 fmt.Sprintf("%d", number) 
21 } 

22 } 


在 代码 清单 9-29 的 第 14 行 ， 可 以 看 到 第 一 个 基准 测试 函数 ， 名 为 BenchmarkSprintf。 
基准 测试 函数 必须 以 Benchmark 开头 ， 接 受 一 个 指向 testing.B 类 型 的 指针 作为 唯一 参数 。 
为 了 让 基准 测试 框架 能 准确 测试 性 能 , 它 必 须 在 一 段 时 间 内 反复 运行 这 段 代 码 , 所 以 这 里 使 用 了 
for 循环 ， 如 代码 清单 9-30 所 示 。 





代码 清单 9-30 listing28_testgo: 第 19 行 到 第 22 行 


49 for i := 0; i < b.N; i++ { 

20 fmt.Sprintf("%d", number) 
娄 业 

22 } 


代码 清单 9-30 第 19 行 的 for 循环 展示 了 如 何 使 用 b.N 的 值 。 在 第 20 行 ， 调 用 了 fmt 包 





里 的 Sprintf 消 数 。 这 个 函数 是 将 要 测试 的 将 整数 值 转 为 字符 串 的 函数 。 
基准 测试 框架 默认 会 在 持续 1 秒 的 时 间 内 , 反复 调用 需要 测试 的 函数 。 测试 框架 每 次 调用 测 
试 函数 时 ， 都 会 增加 b.N 的 值 。 第 一 次 调用 时 ，b.N 的 值 为 1。 需 要 注意 , 一定 要 将 所 有 要 进 
行 基准 测试 的 代码 都 放 到 循环 里 ， 并 且 循 环 要 使 用 b.N 的 值 。 否 则 ， 测 试 的 结果 是 不 可 靠 的 。 
如 果 我 们 只 希望 运行 基准 测试 函数 ， 需 要 加 入 -bench 选项 ， 如 代码 清单 9-31 所 示 。 























代码 清单 9-31 ”运行 基准 测试 
go test -V -run="none" -bench="BenchmarkSprintf" 
在 这 次 go test 调用 里 ,我 们 给 -run 选项 传递 了 字符 串 "none" ， 来 保证 在 运行 制订 的 基 
准 测 试 函数 之 前 没有 单元 测试 会 被 运行 。 这 两 个 选项 都 可 以 接受 正则 表达 式 , 来 决定 需要 运行 哪 
些 测试 。 由 于 例子 里 没有 单元 测试 函数 的 名 字 中 有 none ， 所 以 使 用 none 可 以 排除 所 有 的 单元 
测试 。 发 出 这 个 命令 后 ， 得 到 图 9-14 所 示 的 输出 。 











$ go test -v -run="none" -bench="BenchmarkSprintf" 


testing: warning: no tests to run 

PASS 

BenchmarkSprintf 5000000 258 ns/op 

ok github,.com/goinaction/code/chapter9/listing28 1.562s 


图 9-14 ”运行 单个 基准 测试 























这 个 输出 一 开始 明确 了 没有 单元 测试 被 运行 ， 之 后 开始 运行 BenchmarkSprintf 基准 测 
试 。 在 输出 PASS 之 后 ， 可 以 看 到 运行 这 个 基准 测试 函数 的 结果 。 第 一 个 数字 5000000 表示 在 
循环 中 的 代码 被 执行 的 次 数 。 在 这 个 例子 里 , 一 共 执 行 了 500 万 次 。 之 后 的 数字 表示 代码 的 性 能 ， 
单位 为 每 次 操作 消耗 的 纳 秒 (ns ) 数 。 这 个 数字 展示 了 这 次 测试 ， 使 用 Sprintf 函数 平均 每 次 
花费 了 258 纳 秒 。 

最 后 , 运行 基准 测试 输出 了 ok, 表明 基准 测试 正常 结束 。 之 后 显示 的 是 被 执行 的 代码 文件 的 名 字 。 
最 后 ， 输 出 运行 基准 测试 总 共 消 耗 的 时 间 。 默 认 情 况 下 ， 基 准 测试 的 最 小 运行 时 间 是 1 秒 。 你 会 看 到 
这 个 测试 框架 持续 运行 了 大 约 1.5 秒 。 如 果 想 让 运行 时 间 更 长 ， 可 以 使 用 男 一 个 名 为 -benchtime 的 
选项 来 更 改 测试 执行 的 最 短 时 间 。 让 我 们 再 次 运行 这 个 测试 ， 这 次 持续 执行 3 秒 ( 见 图 9-15 )。 


$ go test -Vv -run="none" -bench="BenchmarkSprintf" -benchtime="3s" 
testing: warning: no tests to run 


























29666669 256 ns/op 





github.com/goinaction/code/chapter9/listing28 5.384s 
9-15 ”使 用 -benchtime 选项 来 运行 基准 测试 
这 次 Sprintf 函数 运行 了 2000 万 次 , 持续 了 5.384 秒 。 这 个 函数 的 执行 性 能 并 没有 太 大 的 
变化 ,这 次 的 性 能 是 每 次 操作 消耗 256 纳 秒 。 有 时 候 ， 增 加 基准 测试 的 时 间 ， 会 得 到 更 加 精确 的 
曙 





网 














性 能 结果 。 对 大 多 数 测试 来 说 , 超过 3 秒 的 基准 测试 并 不 会 改变 测试 的 精确 度 。 
试 的 结果 会 稍 有 不 同 。 


是 每 次 基准 测 


让 我 们 看 另外 两 个 基准 测试 函数 , 并 一 起 运行 这 3 个 基准 测试 , 看 看 哪 种 将 整数 值 转换 为 字 
符 串 的 方法 最 快 ， 如 代码 清单 9-32 所 示 。 








代码 清单 9-32 listing28_testgo: 第 24 行 到 第 46 行 


24 // BenchmarkFormat 对 strconv.FormatInt 函数 
25 // 进行 基准 测试 

26 func BenchmarkFormat (b *testing.B) { 

和 7 number := int64(10) 

















29 b.ResetTimer () 


31 for 主 *= 0 1 < bN; i++ 1{ 

32 strconv.FormatInt (number, 10) 
33 } 

34 } 


36 // BenchmarkItoa 对 strconv.Itoa 函数 
37 // 进行 基准 测试 
38 func BenchmarkItoa (b *testing.B) { 





























39 number := 10 

40 

41 b.ResetTimer () 

42 

43 for i := 0; i < b.N; i++ { 
44 strconv.Itoa (number) 
45 } 

46 1} 


代码 清单 9-32 展示 了 男 外 两 个 基准 测 斌 函数。 函数 BenchmarkFormat 测试 了 strconv 
包 里 的 FormatInt 图 数 ,而 图 数 BenchmarkItoa 测试 了 同样 来 自 strconyv 包 的 Itoa 也 数 。 
这 两 个 基准 测试 函数 的 模式 和 BenchmarkSprintf 函数 的 模式 很 类 似 。 函 数 内 部 的 for 循环 
使 用 b.N 来 控制 每 次 调用 时 迭代 的 次 数 。 

我 们 之 前 一 直 没 有 提 到 这 3 个 基准 测试 里 面 调用 b.ResetTimer 的 作用 ,在 代码 开始 执行 循环 之 
前 需要 进 和 初始 化 时 ， 这 个 方法 用 来 重 置 计 时 器 ， 保 证 测试 代码 执行 前 的 初始 化 代码 ， 不 会 干扰 计时 
器 的 结果 。 为 了 保证 和 2 | 斌 结果 尽量 精确 ， 需 要 使 用 这 个 函数 来 跳 过 初始 化 代码 的 执行 时 间 。 

让 这 3 个 函数 至 少 运行 3 秒 后 ， 我 们 得 到 图 9-16 所 示 的 结 


$ go test -Vv -run="none" -bench=. -benchtime="3s" 
testing: warning: no tests to run 
PASS 














BenchmarkSprintf 20960669666 257 ns/op 
BenchmarkFormat 100606669 45.9 ns/op 
BenchmarkItoa 19006606060 49.4 ns/op 

ok github.com/goinaction/code/chapter9/listing28 15.657s 








图 9-16 ”运行 所 有 3 个 基准 测试 


这 个 结果 展示 了 BenchmarkFormat 测试 函数 运行 的 速度 最 快 , 每 次 操作 耗 时 45.9 纳 秒 。 紧 随 其 
后 的 是 BenchmarkItoa ， 每 次 操作 耗 时 49.4 ns。 这 两 个 函数 的 性 能 都 比 Sprintf 函数 快 得 多 。 

















运行 基准 测试 时 ， 男 一 个 很 有 用 的 选项 是 -benchmem 选项 。 这 个 选项 可 以 提供 每 次 操作 分 
配 内 存 的 次 数 ， 以 及 总 共 分 配 内 存 的 字 节 数 。 让 我 们 看 一 下 如 何 使 用 这 个 选项 ( 见 图 9-17 )。 




















$ go test -vV -run="none'" -bench=， -benchtime="3s" -benchmem 

testing: warning: no tests to run 

PASS 

BenchmarkSprjintf 266006668 55 ns/ / 2 allocs/op 
5 


1 allocs/op 
1 allocs/op 





























图 9-17 ”使 用 -benchmem 选项 来 运行 基准 测试 




















这 次 输出 的 结果 会 多 出 两 组 新 的 数值 : 一 组 数值 的 单位 是 B/op ， 另 一 组 的 单位 是 
allocs/op。 单 位 为 allocs/op 的 值 表示 每 次 操作 从 堆 上 分 配 内 存 的 次 数 。 你 可 以 看 到 
Sprintf 六 数 每 次 操作 都 会 从 堆 上 分 配 两 个 值 ， 而 另外 两 个 函数 每 次 操作 只 会 分 配 一 个 值 。 单 
位 为 B/op 的 值 表示 每 次 操作 分 配 的 字 节 数 。 你 可 以 看 到 Sprintf 函数 两 次 分 配 总 共 消 耗 了 16 
字 节 的 内 存 ， 而 另外 两 个 函数 每 次 操作 只 会 分 配 2 字 节 的 内 存 。 

在 运行 单元 测试 和 基准 测试 时 ,还 有 很 多 选项 可 以 用 。 建 议 读者 查看 一 遍 所 有 选项 ， 以 便 在 
编写 自己 的 包 和 工程 时 , 充分 利用 测试 框架 。 社区 希望 包 的 作者 在 正式 发 布 包 的 时 候 提供 足够 的 
测试 。 
















































































4 小 结 
国 ”测试 功能 被 内 置 到 Go 语言 中 ，Go 语言 提供 了 必要 的 测试 工具 。 
加 go test 工具 用 来 运行 测试 。 
加 测试 文件 总 是 以 _test.go 作为 文件 名 的 结 
国 表 组 测试 是 利用 一 个 测试 孔 数 测试 多 组 值 的 好 办 法 。 
国 包 中 的 示例 代码 ， 既 能 用 于 测试 ， 也 能 用 于 文档 。 
国 ”基准 测试 提供 了 探查 代码 性 能 的 机 制 。 


语言 实战 


即便 不 处 理 类 似 可 扩展 的 Web 并 发 或 者 实时 性 能 等 复杂 的 系统 
编程 问题 ， 应 用 程序 开发 也 是 一 件 非 常 困难 的 事情 。 尽 管 使 用 一 些 工 
具 和 框架 也 可 以 解决 这 些 常见 的 问题 ,但 Go 语言 却 以 一 种 更 加 自然 
且 高 效 的 方式 正确 处 理 了 这 类 问题 。 由 谷歌 公司 开发 的 Go 语言， 为 
在 基础 设施 中 非常 依赖 高 性 能 服务 的 初创 公司 和 大 企业 提供 了 足够 的 
能 力 。 

本 书目 标 读者 是 已 经 有 一 定 其 他 编程 语言 经 验 ， 想 要 开始 学 习 
Go 语言 或 者 更 深入 了 解 Go 语言 及 其 内 部 机 制 的 中 级 开发 者 。 本 书 
会 提供 一 个 专注 、 全 面 且 符 合 习 惯 的 视角 。 本 书 关注 Go 语言 的 规范 
和 实现 ， 涉 及 的 内 容 包 括 语法 、Go 的 类 型 系统 、 并 发 、 通 道 和 测试 
等 主题 。 


本 书 主 要 内 容 


日 Go 语言 规范 和 实现 。 

® ”Go 语言 的 类 型 系统 。 

e ”Go 语言 的 数据 结构 的 内 部 实现 。 
e 测试 和 基准 测试 。 


本 书 假设 读者 是 熟练 使 用 其 他 语言 ( 如 Java、Ruby、Python、 
C# 或 者 C++ ) 的 开发 者 。 


William Kennedy 是 一 位 熟练 的 软件 开发 者 ， 也 是 博客 GoingGo. 
Net 的 作者 。Brian Ketelsen 和 Erik St. Martin 是 全 球 Go 
语言 大 会 GopherCon 的 组 织 者 ， 也 是 Go 语言 框架 Skynet 的 联合 作者 。 
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